Cancel Hansel API Quickstart

End-to-end sandbox flow

1. Register a partner.
2. Create an API key.
3. Create a booking.
4. Protect the booking.
5. Inspect webhook events.
6. Retrieve policy evaluation.
7. Export an evidence packet.

1. Register a partner

curl -X POST https://api.cancelhansel.com/v1/partners/register   -H "Content-Type: application/json"   -d '{
  "name": "Acme Booking",
  "businessType": "Venue Operator",
  "contactEmail": "[email protected]",
  "website": "https://example.com"
}'

This creates a partner account and enables access to API key creation and booking management APIs.

2. Create an API key

curl -X POST https://api.cancelhansel.com/v1/api-keys   -H "Content-Type: application/json"   -H "x-api-key: YOUR_API_KEY"   -d '{
  "name": "server-integration-key",
  "scopes": ["bookings:write","webhooks:read"]
}'

3. Create a booking

curl -X POST https://api.cancelhansel.com/v1/bookings   -H "Content-Type: application/json"   -H "x-api-key: YOUR_API_KEY"   -d '{
  "partnerId": "partner_abc123",
  "talent": {"id":"talent_1","name":"Live Band"},
  "organizer": {"id":"org_9","name":"Event Team"},
  "eventType": "concert",
  "eventDate": "2026-05-15T19:00:00Z",
  "bookingValue": 4500.00,
  "currency": "USD"
}'

4. Protect the booking

curl -X POST https://api.cancelhansel.com/v1/bookings/booking_789/protect   -H "x-api-key: YOUR_API_KEY"

Protecting a booking captures evidence and triggers lifecycle evaluation for dispute support.

5. Inspect webhook events

curl -X GET https://api.cancelhansel.com/v1/bookings/booking_789/webhook-events   -H "x-api-key: YOUR_API_KEY"

Use webhook event retrieval to confirm lifecycle delivery status and webhook signatures.

6. Retrieve policy evaluation

curl -X GET https://api.cancelhansel.com/v1/bookings/booking_789/policy-evaluation   -H "x-api-key: YOUR_API_KEY"

Review policy evaluation results to understand cancellation or dispute outcomes for the protected booking.

7. Export an evidence packet

Export a protected booking evidence packet as JSON or PDF to support partner operations and dispute review.

curl -X POST https://api.cancelhansel.com/v1/bookings/booking_789/evidence   -H "x-api-key: YOUR_API_KEY"   -d '{"format":"json"}'