Repository navigation
Access levels
Arihant edited this page Nov 16, 2026
·
12 revisions
The API has different levels, controlling the access to the information or the ability to POST bookings.
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}/reviews/tour/{tour_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 |
|---|---|
| MASTER_BILL | /configuration/{version} |
| /{version}/configuration/payment | |
| /{version}/availabilities/status/changes | |
| /{version}/bookings | |
| /{version}/bookings/{booking_hash} | |
| /{version}/carts | |
| /{version}/carts/{shopping_cart_hash} | |
| /{version}/categories | |
| /{version}/categories/{category_id} | |
| /{version}/options/{option_id} | |
| /{version}/reviews/tour/{tour_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 |
| MASTER_BILL | teaser, full, home |
Copyright 2025 GetYourGuide GmbH.