11 Get booking by your reference | Global Airport Concierge

{
  "message": "Successfully!",
  "status": 200,
  "responseTime": "119ms",
  "trace": [],
  "data": {
    "billing": {
      "add_hrs_charge": 0,
      "grand_total": 622.2,
      "status": 0,
      "surcharge": 0,
      "tax": 0,
      "tax_rate": 0,
      "total_booking_cost": 622.2,
      "total_discount": 0,
      "total_paid": "0.00",
      "total_refund_amount": 0
    },
    "booker_id": 39083,
    "created_at": "2026-08-24T19:38:10+00:00",
    "currency": {
      "code": "GBP",
      "decimal_digits": 2,
      "id": 3,
      "multiplier": 0.85,
      "name": "British Pound Sterling",
      "name_plural": "British pounds sterling",
      "rounding": 0,
      "symbol": "£",
      "symbol_native": "£"
    },
    "currency_id": 3,
    "expires_on": "2026-08-31T19:38:12+00:00",
    "id": 34604,
    "journeys": [
      {
        "adult": 2,
        "bag_large": 0,
        "bag_medium": 1,
        "bag_small": 0,
        "child": 0,
        "flight": "EK1",
        "infant": 0,
        "passengers": {
          "adult": [
            {
              "class_type": "Economy Class",
              "contacts": [
                {
                  "contact_person": "John Doe",
                  "type": "phone",
                  "value": "+441234567890"
                }
              ],
              "first_name": "John",
              "last_name": "Doe",
              "lead": true,
              "pnr": "ABC123",
              "signage": "John Doe",
              "title": "Mr",
              "type": "adult"
            }
          ],
          "child": [],
          "infant": []
        },
        "stops": {
          "arrival": {
            "airport": {
              "iata": "AUH",
              "id": 113,
              "name": "AUH Abu Dhabi International Airport"
            },
            "airport_id": 113,
            "services": [
              {
                "id": 1,
                "service_name": "Meet & Assist",
                "surcharge": 0,
                "value": 425
              },
              {
                "id": 4,
                "service_name": "Lounge Access",
                "surcharge": 0,
                "value": 1
              }
            ]
          }
        }
      }
    ],
    "ref_no": "GAC-6A8C9DA2A683B",
    "settings": {
      "customer_reference": "PM-1787600290",
      "no_additional_hour_charges": false,
      "no_surcharge": false
    },
    "status": "quote"
  }
}

Fetches one booking in full by the settings.customer_reference you supplied when you created it. Same response as 09 Get booking by ID.

This is the most useful lookup for an integration, because the reference is yours: you know it before we reply, it never changes, and it survives a replace. Send one on every quote.

Status	`error_code`	When
`200`	—	Found. `message` is `Successfully!`
`404`	`booking_not_found`	Unknown reference, or a booking that is not yours.
`401`	`unauthenticated`	Bearer token missing, invalid or expired.
`500`	`server_error`	Our fault.

Use it to recover from a failed create. There is no idempotency on quote creation, so if a request times out you cannot tell whether the booking was made. Retry with the same customer_reference: a 422 with errors["settings.customer_reference"] proves the first attempt landed, and this endpoint then hands you that booking. That is the safest retry pattern available today.

References are unique per company, so yours cannot collide with another partner’s.

Fetches one booking in full by the `settings.customer_reference` you supplied when you created it. Same response as **09 Get booking by ID**. This is the most useful lookup for an integration, because the reference is yours: you know it before we reply, it never changes, and it survives a replace. Send one on every quote. | Status | `error_code` | When | | --- | --- | --- | | `200` | — | Found. `message` is `Successfully!` | | `404` | `booking_not_found` | Unknown reference, or a booking that is not yours. | | `401` | `unauthenticated` | Bearer token missing, invalid or expired. | | `500` | `server_error` | Our fault. | **Use it to recover from a failed create.** There is no idempotency on quote creation, so if a request times out you cannot tell whether the booking was made. Retry with the same `customer_reference`: a `422` with `errors["settings.customer_reference"]` proves the first attempt landed, and this endpoint then hands you that booking. That is the safest retry pattern available today. References are unique per company, so yours cannot collide with another partner's.

Authentication

AuthorizationBearer

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

Response

messagestring

statusinteger

responseTimestring

tracelist of any

dataobject

Errors

404

Not Found Error

Fetches one booking in full by the settings.customer_reference you supplied when you created it. Same response as 09 Get booking by ID.

This is the most useful lookup for an integration, because the reference is yours: you know it before we reply, it never changes, and it survives a replace. Send one on every quote.

Status	`error_code`	When
`200`	—	Found. `message` is `Successfully!`
`404`	`booking_not_found`	Unknown reference, or a booking that is not yours.
`401`	`unauthenticated`	Bearer token missing, invalid or expired.
`500`	`server_error`	Our fault.

References are unique per company, so yours cannot collide with another partner’s.

$	curl https://api-prod.globalairportconcierge.com/api/v1/bookings/customer-reference/%7Bcustomer_reference%7D \
>	-H "Authorization: Bearer <token>"