API reference

Every endpoint in Awrora API v1 — generated from the API's own schemas.

Every endpoint in Awrora API v1 (version 2026-09-09). The reference is generated from the same zod schemas the API validates against, so it's always up to date. Start with the API overview for authentication, errors and pagination, or download the OpenAPI spec.

Account#

Your key and this document.

Who am IGET/v1/me

Experiences#

The catalogue.

List experiencesGET/v1/experiences
Get an experienceGET/v1/experiences/{id}

Availability#

Departures and live seat counts.

List departures with live seat countsGET/v1/availability

Bookings#

Bookings on departures.

List bookingsGET/v1/bookings
Get a bookingGET/v1/bookings/{id}
Create a bookingPOST/v1/bookings
Cancel a bookingPOST/v1/bookings/{id}/cancel

Customers#

The customer register.

List customersGET/v1/customers
Get a customerGET/v1/customers/{id}
Create or reuse a customerPOST/v1/customers
Update a customerPATCH/v1/customers/{id}

Gift cards#

Issued gift cards and their balances.

List gift cardsGET/v1/gift-cards
Get a gift cardGET/v1/gift-cards/{id}

Webhooks#

Signed, retried event delivery to your own endpoints. See https://docs.awrora.se/api/webhooks for the envelope, the signature and the retry schedule.

List webhook endpointsGET/v1/webhooks
Create a webhook endpointPOST/v1/webhooks
Get a webhook endpointGET/v1/webhooks/{id}
Update a webhook endpointPATCH/v1/webhooks/{id}
Delete a webhook endpointDEL/v1/webhooks/{id}
List deliveries for an endpointGET/v1/webhooks/{id}/deliveries
Retry a deliveryPOST/v1/webhooks/{id}/deliveries/{deliveryId}/retry
Send a test deliveryPOST/v1/webhooks/{id}/test
Rotate the signing secretPOST/v1/webhooks/{id}/rotate-secret

Events#

Everything that has happened, newest first.

List eventsGET/v1/events
Get an eventGET/v1/events/{id}

Webhook events#

Events that can be sent to your webhooks, and the scope the key needs to read them.

  • booking.createdbookings:read
  • booking.confirmedbookings:read
  • booking.cancelledbookings:read
  • booking.rescheduledbookings:read
  • customer.createdcustomers:read
  • customer.updatedcustomers:read
  • gift_card.issuedgift_cards:read
  • gift_card.redeemedgift_cards:read