Get All Reservations

Returns the reservations, across all of the user's listings, that changed at or after updatedSince. Use it as the backstop for missed webhooks: if your server was down or a webhook didn't arrive, this call returns the reservations that changed in the meantime.

A reservation counts as changed when anything on it changes, including a new message. The reservations come in the same shape as /api/getReservations/{listingID}, and from the same listings: disabled listings are included, hidden and deleted listings are not. The same statuses are returned too (accepted, inquiry, pending, timedout and cancelled).

Reservations are returned oldest change first, up to limit per page. To get the next page, pass the returned nextCursor as cursor, with the same updatedSince. Keep going until nextCursor is null. A page can hold fewer than limit reservations even when more remain, so don't stop at a short page. A reservation that changes again while you page moves to the end, so you get it again rather than miss it.

To poll: save the time just before your first call, minus a minute for clock differences. Page until nextCursor is null, then pass the saved time as updatedSince on the next poll.

Some changes drop out instead of being reported. A reservation that is deleted, or whose status changes to one outside the set above (for example a pending request that becomes denied), is no longer returned, so you won't see that change here.

Requires the reservations:read scope.

Authentication: Pass either Authorization: Bearer <token> (OAuth 2.0) or the legacy authToken header.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
date-time
required

Only return reservations that changed at or after this time (ISO 8601 date-time). Required. A missing or invalid value returns 400.

integer
1 to 200
Defaults to 100

Maximum number of reservations in one page (1-200). Defaults to 100.

string

The nextCursor value from the previous page. Treat it as an opaque string: don't build or change it yourself.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

403

The OAuth token doesn't have the reservations:read scope

429

Too many requests

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json