08 List bookings | Global Airport Concierge

Lists your bookings, newest first. Only your own company’s bookings are ever returned.

Parameter	Type	Default	Notes
`page`	integer	`1`
`limit`	integer	`25`	Maximum `100`.
`query`	string	—	A JSON-encoded object, not a plain search term. Max 5000 characters.

The query parameter

query must be JSON. Send it URL-encoded, for example query={"text":"GAC-6A8C"}.

Key	Type	Matches
`text`	string	Booking reference, passenger PNR, passenger name, booker name, booker email, or flight number. Partial matches count.
`airports`	array of ids	Bookings touching those airports.
`services`	array of ids	Bookings containing those services.
`booking_status`	array of strings	`quote`, `booking`, `cancelled`.

If query is not valid JSON it is ignored silently and you get everything back, which looks like a filter that matched broadly rather than one that failed. Check your encoding if the count looks wrong.

There is no date filter of any kind, and no updated_since. Reconciling a period means paging the whole history newest-first until you pass the dates you care about.

Response

The paginated envelope. Note that trace is omitted entirely on this endpoint, unlike every other one.

1 "pagination": { "total_count": 7, "total_pages": 4, "current_page": 1, "limit": 2 }

Each row is a summary, not the full booking: id, ref_no, status, grand_total, currency, booker, services[], lead_passenger, bags, pax. Fetch the full record with 09 Get booking by ID.

Two details that catch people. bags and pax come from the first journey only, so a multi-journey booking under-reports here. And services[].id in this response is a line-item id, not the service id you send when creating a quote; match on service_name instead.

Status	`error_code`	When
`200`	—	Always, even with no matches. `message` is `Successful.`
`422`	`validation_failed`	`limit` above 100, `page` below 1, or `query` over 5000 characters.
`401`	`unauthenticated`	Bearer token missing, invalid or expired.
`500`	`server_error`	Our fault.

Lists your bookings, newest first. Only your own company's bookings are ever returned. | Parameter | Type | Default | Notes | | --- | --- | --- | --- | | `page` | integer | `1` | | | `limit` | integer | `25` | Maximum `100`. | | `query` | string | — | A **JSON-encoded object**, not a plain search term. Max 5000 characters. | ### The query parameter `query` must be JSON. Send it URL-encoded, for example `query={"text":"GAC-6A8C"}`. | Key | Type | Matches | | --- | --- | --- | | `text` | string | Booking reference, passenger PNR, passenger name, booker name, booker email, or flight number. Partial matches count. | | `airports` | array of ids | Bookings touching those airports. | | `services` | array of ids | Bookings containing those services. | | `booking_status` | array of strings | `quote`, `booking`, `cancelled`. | **If `query` is not valid JSON it is ignored silently** and you get everything back, which looks like a filter that matched broadly rather than one that failed. Check your encoding if the count looks wrong. There is **no date filter** of any kind, and no `updated_since`. Reconciling a period means paging the whole history newest-first until you pass the dates you care about. ### Response The paginated envelope. Note that `trace` is omitted entirely on this endpoint, unlike every other one. ```json "pagination": { "total_count": 7, "total_pages": 4, "current_page": 1, "limit": 2 } ``` Each row is a summary, not the full booking: `id`, `ref_no`, `status`, `grand_total`, `currency`, `booker`, `services[]`, `lead_passenger`, `bags`, `pax`. Fetch the full record with **09 Get booking by ID**. Two details that catch people. `bags` and `pax` come from the **first journey only**, so a multi-journey booking under-reports here. And `services[].id` in this response is a line-item id, not the service id you send when creating a quote; match on `service_name` instead. | Status | `error_code` | When | | --- | --- | --- | | `200` | — | Always, even with no matches. `message` is `Successful.` | | `422` | `validation_failed` | `limit` above 100, `page` below 1, or `query` over 5000 characters. | | `401` | `unauthenticated` | Bearer token missing, invalid or expired. | | `500` | `server_error` | Our fault. |

Authentication

AuthorizationBearer

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

Query parameters

pageintegerOptional

Page number. Defaults to 1.

limitintegerOptional

Results per page. Defaults to 25, maximum 100.

Response

messagestring

statusinteger

responseTimestring

datalist of objects

paginationobject

Lists your bookings, newest first. Only your own company’s bookings are ever returned.

Parameter	Type	Default	Notes
`page`	integer	`1`
`limit`	integer	`25`	Maximum `100`.
`query`	string	—	A JSON-encoded object, not a plain search term. Max 5000 characters.

The query parameter

query must be JSON. Send it URL-encoded, for example query={"text":"GAC-6A8C"}.

Key	Type	Matches
`text`	string	Booking reference, passenger PNR, passenger name, booker name, booker email, or flight number. Partial matches count.
`airports`	array of ids	Bookings touching those airports.
`services`	array of ids	Bookings containing those services.
`booking_status`	array of strings	`quote`, `booking`, `cancelled`.

There is no date filter of any kind, and no updated_since. Reconciling a period means paging the whole history newest-first until you pass the dates you care about.

Response

The paginated envelope. Note that trace is omitted entirely on this endpoint, unlike every other one.

1 "pagination": { "total_count": 7, "total_pages": 4, "current_page": 1, "limit": 2 }

Status	`error_code`	When
`200`	—	Always, even with no matches. `message` is `Successful.`
`422`	`validation_failed`	`limit` above 100, `page` below 1, or `query` over 5000 characters.
`401`	`unauthenticated`	Bearer token missing, invalid or expired.
`500`	`server_error`	Our fault.

$	curl -G https://api-prod.globalairportconcierge.com/api/v1/bookings \
>	-H "Authorization: Bearer <token>" \
>	-d limit=25 \
>	-d page=1

1	{
2	"message": "Successful.",
3	"status": 200,
4	"responseTime": "69ms",
5	"data": [
6	{
7	"id": 34605,
8	"ref_no": "GAC-6A8C9DA39E4A8",
9	"status": "quote",
10	"grand_total": "622.2",
11	"currency": {
12	"name": "British Pound Sterling",
13	"symbol": "£",
14	"code": "GBP"
15	},
16	"booker": {
17	"forename": "Team",
18	"email": "tech@tripadd.com"
19	},
20	"services": [
21	{
22	"id": 205570,
23	"service_name": "Meet & Assist"
24	},
25	{
26	"id": 205571,
27	"service_name": "Lounge Access"
28	}
29	],
30	"lead_passenger": {
31	"name": "Mr John Doe",
32	"surname": "Doe",
33	"pnr": "ABC123",
34	"class": "Economy Class"
35	},
36	"bags": {
37	"small": 0,
38	"medium": 1,
39	"large": 0
40	},
41	"pax": {
42	"adult": 2,
43	"child": 0,
44	"infant": 0
45	}
46	},
47	{
48	"id": 34604,
49	"ref_no": "GAC-6A8C9DA2A683B",
50	"status": "quote",
51	"grand_total": "622.2",
52	"currency": {
53	"name": "British Pound Sterling",
54	"symbol": "£",
55	"code": "GBP"
56	},
57	"booker": {
58	"forename": "Team",
59	"email": "tech@tripadd.com"
60	},
61	"services": [
62	{
63	"id": 205574,
64	"service_name": "Meet & Assist"
65	},
66	{
67	"id": 205575,
68	"service_name": "Lounge Access"
69	}
70	],
71	"lead_passenger": {
72	"name": "Mr John Doe",
73	"surname": "Doe",
74	"pnr": "ABC123",
75	"class": "Economy Class"
76	},
77	"bags": {
78	"small": 0,
79	"medium": 1,
80	"large": 0
81	},
82	"pax": {
83	"adult": 2,
84	"child": 0,
85	"infant": 0
86	}
87	}
88	],
89	"pagination": {
90	"total_count": 7,
91	"total_pages": 4,
92	"current_page": 1,
93	"limit": 2
94	}
95	}