Reservio API v2 (2.0.0)

All requests must be authenticated with a Bearer access token. How you obtain the token depends on whether you are a Reservio customer or a partner.

Customer API access (Pro plan)

API access is included in the Pro plan. To get access, contact our customer care team — they will issue an API access token for your account.

Use the issued token to authenticate every request:

Authorization: Bearer {token}

Partner API access

Partners (integrating with Reservio without being a Reservio customer) receive their own client_id and client_secret. To obtain an access token, send a POST /oauth2/token request with the following body parameters:

• grant_type with the value client_credentials
• client_id with the client's ID
• client_secret with the client's secret
• scope with a space-delimited list of requested scope permissions

The authorization server responds with a JSON object containing:

• token_type with the value Bearer
• expires_in with an integer representing the TTL of the access token
• access_token — a JWT signed with the authorization server's private key

Use the returned access_token to authenticate every request, the same way as above.

Testing your token

Once you have a token, verify that it works with a simple request:

curl \
    -H "Authorization: Bearer {token}" \
    https://api.reservio.com/v2/users/me

If the response is not HTTP 200, do not send any other requests — they will fail. Contact our support instead.

This API follows the JSON:API specification.

• Sorting is done via ?sort=(direction)column, for example ?sort=-createdAt (descending by the createdAt column).
• Filtering is done via ?filter[name]=Bob or ?filter[booking.event.id]=10.
• Pagination — collection responses include a top-level links object with first, last, next and prev page links (first can be equal to last, next can be null, etc.).

Reservio does not currently support webhooks (i.e. sending payloads from Reservio after an event occurs, for example when a booking is created). You can achieve a similar result by polling. For example, list the most recent bookings sorted by createdAt in descending order every hour or so:

https://api.reservio.com/v2/businesses/{businessId}/bookings?sort=-createdAt