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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
403The OAuth token doesn't have the reservations:read scope
429Too many requests