Home

GetYourGuide Partner API Documentation

The Partner API lets you search, price and book more than 75,000 activities on the GetYourGuide marketplace through a modern, JSON-based REST interface — enabling you to surface curated experiences on your own platform while we handle fulfilment and customer support.

Why integrate?

What you get	How it helps
Real-time catalogue & availability	Always show up-to-date options, pricing and ticket quotas
End-to-end booking flow	Complete purchases in one session using our secure payment set-up
Granular access tiers	Choose the permission level that matches your use case (read-only, availability & pricing, or full booking)
OpenAPI spec & SDK generation	Generate client libraries in 50+ languages with openapi-generator
Robust rate limits	Tell us about your traffic, we will set up rate limit according to your system needs.

The full OpenAPI spec and a Postman collection live in the root of this repository for quick prototyping.

Quick-start checklist

1. Request an API key from your Partner Manager.

2. Test a simple call:

   curl -H "X-ACCESS-TOKEN: YOUR_TOKEN" \
        -H "Accept: application/json" \
        "https://api.getyourguide.com/1/tours?q=Berlin&cnt_language=en&currency=EUR"

3. Inspect the JSON response and follow the Getting Started guide for headers, query parameters, supported currencies and languages.

4. Move on to Access levels to confirm which endpoints are enabled for your key.

5. Implement the Booking flow (tours → availability → price-breakdown → bookings).

Core concepts

Base URL & versioning

All examples use version 1: https://api.getyourguide.com/1/. Future breaking changes will be released under a new major path (/2/, /3/, …) to keep integrations stable.

Authentication

Send your token in the X-ACCESS-TOKEN header; all requests must be made over TLS 1.2+.

Access tiers

• BASIC / LIMITED_READ – catalogue only
• READ – adds live availability & pricing
• BOOKING – full end-to-end booking + payments

See the Access levels page for the exact endpoint matrix.

Stay Up-To-Date by Subscribing to RSS Feeds

How to Subscribe to Repository Updates

Stay up-to-date with the latest changes to the GetYourGuide Partner API Specification by subscribing to the repository's RSS feed.

Adding the RSS Feed to Your Reader

1. Copy the RSS feed URL for the repository:

   https://github.com/getyourguide/partner-api-spec/commits.atom
   

2. Open your preferred RSS reader and add this URL as a new subscription

Alternative Subscription Methods

• Watch the Repository: Click the "Watch" button at the top of the repository page to receive notifications through GitHub

Benefits

• Receive immediate notifications when changes are made to the API specification
• Stay informed about breaking changes and new features. Please rest assured that you will receive additional communications, and have enough time for implementing any breaking changes.
• Never miss important updates that might affect your integration

Documentation map

Section	Purpose
Getting Started	Headers, base URL, currencies, languages, rate limits
Access levels	Which endpoints are unlocked per tier
Making a booking	Step-by-step tutorial & sample payloads
Image formats	Available sizes for responsive media
Questions parameter	Schema for passenger & booking questions

The full OpenAPI spec and a Postman collection live in the root of this repository for quick prototyping.

Support & resources

• Partner Portal: operational dashboards and product assets
• API Reference: interactive endpoint explorer (Swagger UI)
• Security contact: [email protected]

© 2025 GetYourGuide GmbH – All rights reserved.