-
Notifications
You must be signed in to change notification settings - Fork 3
Access levels
Luis R. Carrera edited this page Jan 20, 2026
·
9 revisions
The API has different levels, controlling the access to the information or the ability to POST bookings. If you are unsure about your level, you can call the /{version}/configuration/privileges endpoint.
There is a different set of endpoints available for each access level.
| Level | Available Endpoints |
|---|---|
| BASIC/LIMITED_READ | /configuration/{version} |
| /{version}/categories | |
| /{version}/categories/{category_id} | |
| /{version}/tours | |
| /{version}/tours/{tour_id} |
| Level | Available Endpoints |
|---|---|
| READ | /configuration/{version} |
| /{version}/categories | |
| /{version}/categories/{category_id} | |
| /{version}/options/{option_id} | |
| /{version}/suppliers/{supplier_id} | |
| /{version}/tours | |
| /{version}/tours/{tour_id} | |
| /{version}/tours/{tour_id}/availability | |
| /{version}/tours/{tour_id}/price-breakdown | |
| /{version}/tours/{tour_id}/options |
| Level | Available Endpoints |
|---|---|
| BOOKING | /configuration/{version} |
| /{version}/configuration/payment | |
| /{version}/bookings | |
| /{version}/bookings/{booking_hash} | |
| /{version}/carts | |
| /{version}/carts/{shopping_cart_hash} | |
| /{version}/categories | |
| /{version}/categories/{category_id} | |
| /{version}/options/{option_id} | |
| /{version}/suppliers/{supplier_id} | |
| /{version}/tours | |
| /{version}/tours/{tour_id} | |
| /{version}/tours/{tour_id}/availability | |
| /{version}/tours/{tour_id}/price-breakdown | |
| /{version}/tours/{tour_id}/options |
Some GET requests have the option to pass the query parameter preformatted, which controls the amount/composition of the information returned from the given endpoint.
| Level | Available formatting options |
|---|---|
| BASIC/LIMITED_READ | teaser |
| READ | teaser, full, home |
| BOOKING | teaser, full, home |
Copyright 2025 GetYourGuide GmbH.