09 Get booking by ID

View as Markdown
Fetches one booking in full by our numeric id, the `data.id` returned when you created it. Works at any status, including cancelled. Read-only, no side effects. ### Responses | Status | `error_code` | When | | --- | --- | --- | | `200` | — | Found. `message` is `Successfully!` | | `404` | `booking_not_found` | Unknown id, or a booking that is not yours. The two are deliberately indistinguishable. | | `404` | `endpoint_not_found` | The id was not numeric, so no route matched. Use **10 Get booking by GAC reference** for `GAC-…` strings. | | `401` | `unauthenticated` | Bearer token missing, invalid or expired. | | `500` | `server_error` | Our fault. | ### What comes back Root: `id`, `ref_no`, `status`, `expires_on`, `created_at`, `currency`, `currency_id`, `booker_id`, `promo_code`, `settings`, `journeys[]`, `billing`. Each journey carries `flight`, the passenger counts, `passengers` grouped by type, and `stops.arrival` / `stops.departure` (either may be `null`). Each stop carries its `airport` and its `services[]`, and each service line has `id` (the service id), `value`, `surcharge` and `service_name`. `billing.status` is an integer: `0` unpaid, `1` payment intent created, `2` paid by card, `3` invoiced. Where a greeter has been assigned, `services[].allocation` carries their name, email and phone so you can coordinate on the day. It is `null` until then. **This is the only way to learn about a change.** There are no webhooks, so if GAC operations cancel or amend a booking, polling here is how you find out.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

OK
messagestring
statusinteger
responseTimestring
tracelist of any
dataobject

Errors

404
Not Found Error