Partners FAQ’s
Reservation
A Reservation refers to the process of initiating a booking by temporarily holding a requested product quantity. It corresponds to the moment when a customer adds a product to their cart, ensuring that availability is verified before finalizing the booking.
This process helps reduce the risk of booking failure by confirming that the requested product can be secured before payment. If the booking is not completed within the defined holding period, the reservation is automatically canceled, and the availability is released.
Product ID
Within GetYourGuide, the term "Product" can have different meanings depending on the context. For instance, when discussing tours, you may see "Product" used to refer to activities.
In connectivity terms, any mention of "Product," "Product ID," or "External Product ID" in our documentation specifically refers to the activity identifier in your system. This is the product that is connected to our platform, and for which we will request availability.
Supplier ID
Target Endpoint: Products List, Product Details, Register a new supplier
Supplier ID, or Supplier External ID, refers to any identifier assigned to the supplier in your reservation system that allows for identifying their account and products within your system.
When mapping an option, I received an error mentioning that there was no availability. What should I check?
If you or the supplier receive an error while mapping an option, and the error mentions a lack of availability, please review all details in the error message. This could indicate an issue related to either the get-availability or the reservation test.
Step 1: Troubleshooting Get-Availability Errors
When mapping an option, our system attempts to locate at least two available timeslots within the next 365 days, starting from the closest dates. If the error states that no available dates could be found, confirm that the product ID is correctly returning availability.
To troubleshoot availability:
- Use our [testing tool] and select Test Get-Availabilities as the test case.
- Enter your product ID and availability type, then select the dates for which availability should be returned.
If no dates are returned, check that the product ID is correctly set up to return availability for the requested period.

Step 2: Troubleshooting Reservation Errors
If the error message indicates a lack of availability during a reservation attempt, the cause might be different. This issue often arises due to a NO_AVAILABILITY error encountered during the reservation test.
Our system only initiates reservation tests for dates where availability has already been provided, and the requested vacancies won’t exceed those indicated by the supplier.
To troubleshoot reservations:
- Confirm that the NO_AVAILABILITY error is being returned correctly. This error should only be returned if there aren’t enough vacancies to meet the reservation request.
- Use the Test Reserve/Cancel-Reservation test case in the testing tool.
When testing, select dates with confirmed availability and ensure that the same categories specified by the supplier for the option on GetYourGuide are included. You can also test single categories to confirm the correct responses:
- If a category is unavailable or must be booked together with an adult, an INVALID_CATEGORY error should be returned instead of a NO_AVAILABILITY error.
Following these steps will help verify that the NO_AVAILABILITY error is being returned correctly during reservations.

Product list is not shown in the supplier portal, or a product is not visible in the list.
Requirement: The Product List endpoint is an optional feature. Before troubleshooting, ensure that it has been successfully tested and activated in the Feature list.
For our system to call this endpoint, the supplier’s account on GetYourGuide (GYG) must be associated with the Supplier ID from your system. This association occurs under the following conditions:
- The supplier has registered through the API.
- The supplier has at least one product connected to the system.
Once a product is connected, our system will call the Product Details endpoint, where we retrieve the Supplier ID.
Troubleshooting: No Product List Displayed
If the product list isn't shown, there are three possible reasons:
- No Connected Products
The supplier has no connected products. You can verify this using our analytics to check whether the supplier has already connected a product. - Invalid Product Details Payload
The payload received via the Product Details endpoint may contain invalid data, preventing successful validation. Please review the parameters for this endpoint to ensure accuracy. [Review parameters here] - Product Details Endpoint Not Triggered
No product has been connected since the Product Details endpoint was activated. This should be verified to ensure the connection was correctly established.
Troubleshooting: Specific Product Not Displayed
If a specific product isn’t appearing in the list, the issue may be due to:
- Multiple Supplier Accounts
The supplier has multiple accounts in your system. In GYG, a supplier’s account can only be associated with a unique Supplier ID (typically the one linked to the first product connected). Therefore, the supplier will only see products from the account that matches the associated Supplier ID. - Product Linked to a Different Option
The specific product might already be connected to a different option. You can troubleshoot this through our analytics.
Manual Product Addition
If the product isn’t displayed in the list, you can use the option provided at the end of the list to manually add the product.

Is it possible to build options without logging into the Supplier Portal?
Requirements: Product Endpoints should have been already tested and activated.
While option creation begins in the Supplier Portal, implementing the Product endpoints can streamline the setup process by letting suppliers import essential details directly. These GET endpoints pull data at key stages, enabling suppliers to import option descriptions, locations, price categories, and related settings into the system.
When all three endpoints are fully activated, suppliers gain flexibility in managing product details with greater speed and accuracy, reducing reliance on manual input through the Supplier Portal.
What Is the Difference Between Sending Prices Along with Availability Versus Using the Price Categories Endpoint?
Requirements: This endpoint should have been already tested and activated.
The Price Categories endpoint is designed to help suppliers configure options by providing key pricing information. This endpoint is triggered when the supplier begins adding prices to an option and imports the relevant data.
Steps for Creating Prices
- Upon successfully calling the Price Categories endpoint, categories, capacity, and prices are automatically suggested to the supplier. Suppliers can modify these values or save them and proceed to the next step.
- Once imported, this pricing information is fixed for the option, meaning the price will remain consistent across the entire calendar.
Alternative: Sending Prices Along with Availability
- Alternatively, if you choose to send rates along with availability via API, the price data received will override any previously imported information.
Product endpoints: when are these endpoints called by GYG?
Requirements: Endpoints must be tested and activated.
All product endpoints are GET endpoints, which means data can only be pulled from GetYourGuide’s system, not sent to it. Here is a description of which scenarios trigger the call to these endpoints:
- Product List:
- Purpose: Pulls the list of all active product IDs for the supplier.
- Trigger: This endpoint is called when the supplier selects the reservation system to connect GYG Option..
- Functionality: Once a product is selected, the system maps options without manual entry by the supplier.
- Prerequisite: The system must already have identified the supplier ID.
- Product Details:
- Purpose: Pulls detailed product information once a product ID is added.
- Trigger: Automatically called when a new product ID is selected, updating details on GYG’s side.
- Pricing Categories:
- Purpose: Pulls pricing information from your system when suppliers begin creating price categories on GYG
- Trigger: The call is triggered when the supplier clicks "Add New Pricing."
- Functionality: Pricing data can be reviewed and modified by the supplier before finalizing.
Note: Supplier ID is provided via the Product Details endpoint. If no product is connected for the supplier, the Product List endpoint cannot be called.
How can I test and activate any additional endpoints?
Requirements: Your Reservation system must have passed successfully the live testing phase in order to be able to activate the additional features.
Supplier Endpoints
All additional feature endpoints can be tested directly in the Integrator Portal.
In your production environment, you will have a dedicated tab, "Test Additional Features," where you can use a self-test tool to assess all additional "Supplier endpoints."

In the dropdown menu, you can select the endpoint you want to test and add your product ID. Note that the Product Details endpoint will be tested alongside the Product List endpoint.


You can track your progress in the table at the top of the page.
GetYourGuide Endpoints
For the GetYourGuide endpoints, including Push Availability, deals over API, and supplier registration, use the "Test GetYourGuide Endpoints" tab in the production environment.
Here, you'll find the sandbox URL to test your calls, as well as tools to monitor your progress and results.
Important: Important: Your HTTP Basic Auth credentials for any GetYourGuide endpoints can be found at the bottom of the "Set Up Your Testing Configuration" tab.
How to Activate These Endpoints
Once an endpoint has passed its tests successfully, the system will allow you to activate it.
Go to Manage Features under Manage Your Integration to toggle on the endpoint you wish to activate.
Which Are the Additional Endpoints and What Are They Needed For?
In addition to the mandatory endpoints that cover the essential flow of integration, several additional endpoints are available to enhance supplier performance and product management on the GetYourGuide platform. Here is a summary of these endpoints and their purposes:
- Products (Supplier Endpoint)
These endpoints enable suppliers to create and map their offerings efficiently, while avoiding mismatches between the two systems. Key functionalities include:
Product List Endpoint: Provides a list of all active product IDs for the supplier, enabling the identification and selection of products to connect to the platform.
Product Details Endpoint: Delivers detailed information for selected product IDs, including titles, descriptions, and locations, ensuring accurate and consistent product representation.
Pricing Categories Endpoint: Retrieves pricing data to support the creation, review, and refinement of pricing categories, including group size definitions and rates, ensuring seamless integration and consistency between systems.
How should I use the GetYourGuide (GYG) Booking Reference to manage bookings and modifications?
The GetYourGuide (GYG) booking reference is a unique identifier for each customer’s booking journey, from initial reservation through to booking confirmation. Here we can see how it operates at each stage:
- Reservation and Confirmation:
- A unique booking reference is generated during the reservation phase. Once the customer confirms the booking, the reference continues through the booking confirmation.
- If the customer cancels the reservation without completing the booking, this reference is not reused in any future attempts.
- You will not receive duplicate GYG booking references for unrelated requests.
- Re-used References:
There are only two scenarios in which you may encounter a previously issued booking reference:- Reconfirmation Attempts: If a previous booking attempt failed, the same reference might be used to attempt reconfirmation.
- Booking Modifications: If a customer modifies an existing booking, the original booking reference remains the same to maintain continuity.
Tips for Integration:
- It’s recommended that your system checks the GYG booking reference with each request to identify if it has been used before.
- If an incoming booking reference matches a previous one, this generally indicates a modification request by the customer. Correctly identifying this allows you to manage the modification effectively and confirm it within your system.
- Ensuring accurate identification of modifications helps maintain up-to-date booking records and supports a smoother customer experience.
Note: In the API Request Flow, initial reservation details and a booking reference are issued first. Upon payment confirmation, this reference finalizes the booking. If modifications or reconfirmation are necessary, the reference remains consistent to simplify tracking and customer support.
If the book-call is not returning a success response, why is the booking sent to the customer?
The book call is triggered when the customer completes the booking by paying online. This call is meant to confirm a reservation that was placed previously, providing additional details to finalize the booking.
The 2 steps booking process aims to prevent situations in which customers complete a booking that can not be allocated.
Let review the 2 steps:
Step 1: Reservation
Initially, the customer adds the product to its cart, specifying the number of people and the date. This action is managed by the "reserve" endpoint, which checks the possibility to proceed with the booking and, in case of success response, holds the reservation temporarily. Key checks, such as availability and settings, are performed at this stage, when the booking is not yet confirmed.
Part of the information recommended for this endpoint is a reservation-expiration: this information allows you to specify how long the reservation made will be held in your system. You can review more about this parameter here
Step 2: Booking Confirmation
Once the customer proceeds with payment, the "book" call is triggered to finalize the reservation. If the partner system returns an error or invalid response, the booking will still be confirmed on the customer side, but he won’t be able to receive your ticket until this is solved.
Of course we understand that there may be other technical reasons that could let a book call fail. In this situation we prevent the possibility to retry the book call and try to confirm the booking.
You can find more information about the retry process here
Key note: While the "reserve" call ensures that basic checks are performed, an invalid response or an error during the "book" call will not refuse a booking, but only create a bad customer experience.
Can I send a single Ticket for the Booking?
When multiple customers book an activity, GetYourGuide requires a unique ticket for each customer in the booking. Issuing the same ticket for different customers is not valid and will cause the system to fail in confirming the booking.
Using the "Collective" Category
If the supplier cannot provide multiple tickets per booking, you can instead use the "COLLECTIVE" category. This category allows you to issue a single ticket that covers all participants in the booking.
What Needs to be Done:
- No changes are required in other endpoints or the way you manage availability.
- During the reservation and booking process, GetYourGuide will send a request specifying the relevant categories and the number of participants.
- The only adjustment you need to make is to return the "COLLECTIVE" category in your booking response.
The availability has been updated in my system, but it’s not reflected on GetYourGuide website.
If you've updated the availability in your system, but the modifications are not visible on GetYourGuide website, here are some steps to help you troubleshoot:
- Verify the Availability Reply
Begin by confirming that your system’s response for the target dates is accurate. You can easily check this using our troubleshooting tool in the Integrator Portal. Please see [this guide] for instructions on verifying your availability response. - Timing of the Update
When was the availability last updated? Keep in mind that GetYourGuide schedules regular calls to your system to check for updates. Closer dates are checked more frequently but still won’t be displayed immediately. For a detailed overview of the frequency of these checks, refer to the related article.
Best Practice: If the availability change is significant or time-sensitive, consider using the Notify-Availability endpoint to push the update immediately. This will ensure that the new vacancies are reflected faster on our website.
Note: Remember that if you are sending prices over the API, this is considered part of the availability. Any price changes not reflected online should be treated as part of the availability issue and should be troubleshooted in the same way.
- Avoid Removing Time Slots
It’s crucial not to remove time slots that have become unavailable from your reply. For example, if a specific time slot is now fully booked, set its availability to zero instead of omitting it from your response. If we don’t receive an update that availability has changed to zero, the time slot will still appear as available on GetYourGuide.
With which frequency will GYG call the availability?
When mapping an option for the first time, GetYourGuide will quickly request availability for the next 365 days to check for open vacancies. After this initial request, availability will be checked regularly, with more frequent checks for dates that are closer.
The availability check follows this schedule:
- Once per day for the next 30 days
- Every 4 days for the period between 31 and 90 days from today
- Every 8 days for the period between 91 and 365 days from today
If an option is mapped for both availability and prices, availability for the upcoming 7 days will be double-checked every 4 hours.
To optimize response times and reduce payload, the system divides these date ranges into smaller intervals. The size of these intervals depends on the number of timeslots you are providing; more timeslots per day will result in smaller date ranges, with a minimum interval of 1 day.
For further efficiency, availability checks are not performed all at once. Instead, based on the above frequency, these checks are distributed over 8 days.
Please note that bookings received from GetYourGuide are already accounted for in our system until the next availability check. However, we understand that significant changes in availability can sometimes occur. To ensure the most accurate availability and the best customer service experience, we strongly recommend implementing the Notify-availability endpoint.
Can I connect more options with the same product?
We recommend not connecting multiple options to the same product.
Here is why:
- Each option will call availability on a different schedule, so shared availability can lead to inconsistencies.
- Cached availability won’t reflect bookings made for other options, which could result in overbookings.
- As noted in our documentation, information about which option is booked is not sent by default from our system, so you may not be able to track which specific option received the booking.
For more reliable availability handling, we suggest creating separate products for each option. This minimizes booking conflicts and ensures each option’s availability is accurately managed.
Connecting an Option: What Is Needed and What Is Tested
Requirements: System has been already registered and live tested.
When connecting an option, the system performs several tests to ensure proper integration and functionality. The following outlines what is needed and what is tested during this process:
Endpoints Tested
- Get-availability
- Reserve
- Cancel Reserve
Availability Check
- Format Validation: The system verifies that availability data is retrieved in a valid format.
- Price Verification: If prices are connected via the API, the system checks that the prices categories match those set in the Supplier Portal.
- Time Slots Requirement: At least two time slots with vacancies must be provided for testing purposes.
- Response time: An overall reply-time accordingly with our SLA is required.
- Consistency: The system will check if all available time slots are having the same availability format (time point or time period), In case connecting price over API, the same price categories should be returned for all available dates.
Reservation Tests
The system conducts reservation tests under various conditions to ensure reliability:
- Single Person Reservation
- Multiple People Reservation
- Different Categories
A positive response is expected for all these tests. Any errors encountered during these tests may cause the validation to fail.
Cancellation Tests
- Cancel Reservation: The system attempts to cancel the reservation, expecting a positive response.
Availability Management Verification
- Post-Reservation Check: After making a reservation, the system verifies that the vacancies have decreased appropriately.
- Post-Cancellation Check: After canceling the reservation, the system ensures that the released vacancies are correctly added back to your inventory.
Can I Test My New System with an existing Option on GetYourGuide Option?
No, you won’t be able to test with a live GYG option until the final testing phase. However, this isn’t necessary for initial testing.
After registering your new reservation system, you’ll go through three testing phases:
- Phase 1: Initial Self-Testing
- Use the self-testing tool to check basic functionality with only your product ID.
- This phase confirms that your system’s core connections are working, without requiring a live GYG option.
- Phase 2: Advanced Self-Testing
- Continue self-testing to verify advanced interactions using your product ID.
- This ensures that your setup is ready for real-time data and mappings, all without needing access to live GYG options.
- Phase 3: Live Testing with GYG Options
- In this final phase, the GetYourGuide Connectivity team will test your system with active GYG options.
Once this is successfully completed, your system will appear in the Supplier Portal, enabling you to self-map options.
Until Phase 3, you can complete all necessary testing steps with just your product ID, without needing a live GYG option.
Which Tests Can I Run in the Integrator Portal?
The Integrator Portal provides tools to help you test your reservation system integration in both testing and production environments. Below are the details on what you can test in each environment:
Credentials Setup
- You will need to provide credentials for both the testing and production environments.
Self-Testing Tool
The portal includes a self-testing tool to run integration tests in each environment, offering instant results and detailed failure information.
Testing Environment
- By entering the designated product ID, you can test the entire booking flow. This includes all mandatory endpoints, excluding the notify availability endpoint.
- The following features can be tested in the testing environment:
- Availability Calls
- Reserve and Cancel Reserve Endpoints
- Book and Cancel Booking Endpoints
- Error Handling: Verifies proper error responses
- Modification Flow: Tests ability to modify bookings
Production Environment
- In production, you can test the full reservation flow:
- Availability Checks
- Reserve and Cancel Reserve Actions
- Error Handling: Ensures your system manages errors as expected
- Additionally, a dedicated space is available for testing all supplementary feature endpoints.
Group Category: in which scenario should I use this category?
The GROUP category in GetYourGuide's API is designed for activities or services where the product is sold as a single booking, regardless of the number of participants. This category is ideal when pricing is fixed for the activity itself rather than for each individual. Here is how to use the GROUP category effectively in scenarios like these:
- Fixed-Priced Tours: If a tour has a set price that does not change based on the number of participants, the GROUP category is suitable. For example, a private sightseeing tour priced at $200 would stay the same whether one person or six people join.
- Private Rentals: For rentals like vehicles that are intended for private use, the GROUP category allows customers to book without needing individual tickets for each participant. This applies to bookings such as private boat rentals or exclusive car hires, where the total price is for the vehicle, not the number of people.
- Exclusive Bookings (e.g., Restaurant Table Reservations): When customers are booking an exclusive or private experience—such as reserving a table at a restaurant that cannot be shared with other customers—using the GROUP category ensures they have a dedicated booking for their group only.
By using the GROUP category, suppliers can provide flexible booking options for activities where a single ticket covers the full experience, regardless of individual participant numbers, creating a smooth, user-friendly booking process for private experiences.
Please note, since the price set for the GROUP category is tied to the maximum number of individuals allowed, bookings through this category will always be allowed from 1 participant up to the maximum group size specified. If for any reason an option requires a minimum number of participants different from one, then this must be set through individual categories
I need to send additional information that is not covered by GetYourGuide endpoints
Our endpoints and the information they request are structured to display availability online as per our documentation. We understand that some of your activities might have unique requirements or rely on different data retrieval processes. However, additional information that isn't specified in our requests will not be validated.
To ensure a smooth integration, please match the required information as closely as possible. If you need to include extra details, you can add them directly to the tour option in the Supplier Portal.
Example:
If your activity requires both a starting time and an arrival time to confirm availability (e.g., for a transportation service where both times are typically needed), but our API only requests the starting time, a suitable solution is to:
- Set the trip duration in the option description.
- Provide only the starting time in the API request.
This approach maintains alignment with our API while still giving users a clear understanding of the total trip time.
I have products that use different categories, what should I do?
In GetYourGuide’s API, categories are structured to enhance the searchability of activities by associating them with individual participant-based categories only. This means all products must fit into specific categories that describe individual ticket options, like Adult, Child, Youth, or Senior. General or abstract category labels that might represent non-individual characteristics aren’t supported in the system; instead, suppliers are encouraged to align all unique category ideas with the individual-focused categories available in the API.
The single exception is the "GROUP" category, which allows suppliers to define a single ticket for an entire group rather than for each participant. This category specifies the group size for a ticket, allowing it to function independently of individual participant counts and provides flexibility for activities designed for group bookings.
For more details on permitted categories, click [here], and to review best practices for the GROUP category, please refer to the specific article in Basics of Connectivity.
What I need to know about Activities on GetYourGuide before developing my integration?
GetYourGuide (GYG) supports API connections at an option level, enabling you to tailor your system to meet specific requirements.
Overview of Activities on GetYourGuide
Activities on GYG are structured into Tours and Options:
a Tour is a generic product that represents an experience or activity available for booking. It includes all the information about the activity, such as its description, location, highlights, and main details. However, you cannot book a tour directly. it serves as the overarching product that groups its specific, bookable variations.
A Tour Option represents the specific experience a customer will book. It is a specific, bookable instance of a tour that includes all the details necessary for customers to make a booking, such as: Availability, Pricing, conditions
Key Requirements for Options
To be available for sale, each option must have both availability and pricing. Also, Options for the same tour may differ in features, such as:
Inclusion of meals (e.g., lunch)
Availability of additional services (e.g., audioguides)
Different pickup points or durations
For this reason, any option must have its specific Availability and pricing.
Start Times and Opening Hours
Each option can specify its starting times and opening hours:
Starting times: Indicate when a specific activity begins.
Opening hours: Refer to the overall time frame during which a venue or service is available to customers.
This information is essential for providing accurate availability and helping customers plan their activities effectively. Ensure your system accounts for these details to enhance the booking experience.
Price Categories
For each option, you can specify allowed price categories, which may have distinct pricing structures, rates, age ranges, and participant requirements.
Key note: Price categories must represent individuals (e.g., adult, child).
For more details on permitted categories, click here, and to review best practices for the GROUP category, please refer to the specific article in Basics of Connectivity.
If I’m developing a reservation system for my own company, do I still need to integrate all endpoints?
Yes, even if you’re creating an integration solely for your own company or a single supplier, you must still implement all mandatory endpoints to ensure full compatibility with GetYourGuide.
However, we recognize that your company might work with a specific configuration type. When registering your system, specify that it’s being developed for a single supplier. This allows you to test only the configurations you need, tailored to your business requirements.
Note: For systems developed for a single supplier, your integration will only support option mapping for that specific supplier’s account.
Which endpoints are essential to enable basic functionalities while integrating with GetYourGuide?
When integrating with GetYourGuide, it is crucial to understand the key mandatory endpoints that ensure a smooth booking process. These endpoints allow for effective communication between your system and GetYourGuide, providing accurate availability information and efficient reservation management. Below is an overview of the essential endpoints and their functionalities, along with a flow of the integration process.
1. Availability Query
- Purpose: Retrieve up-to-date availability for various products.
- Details:
- Provides availability for each time slot within a specified period.
- Indicates the number of available slots or shows if none are available.
- Optional cut-off time parameter defines the advance notice required for bookings.
- Supports long-term availability checks (up to 365 days in advance).
2. Reservation
- Purpose: Initiate the booking process by reserving product quantities.
- Details:
- Reserves requested quantities for a defined holding time,
- This step also serves as a double-check with your system to ensure the booking can be completed. It verifies product availability and confirms that all conditions (such as available slots, capacity, and any other prerequisites) are met before the booking proceeds.
- Ensures selected products remain available for booking within the holding time.
3. Reservation Cancellation
- Purpose: Manage inventory when a customer removes an item from their cart.
- Details:
- Frees up reserved products, ensuring accurate inventory management.
4. Booking
- Purpose: Confirm a previously placed reservation.
- Details:
- Completes the booking process and provides additional customer and booking details.
- Includes a retry mechanism in case of confirmation failure.
5. Booking Cancellation
- Purpose: Notify your system of a cancellation to keep inventory accurate.
- Details:
- Updates inventory to reflect the canceled booking.
6. Notify Availability
- Purpose: Proactively inform GetYourGuide about significant changes in availability.
- Details:
- Notify about major changes in availability.
- Complements regular scheduled calls for availability to keep information updated.
Additional Note on Pricing
- Integration of Pricing:
Prices can be included in the availability information flow. While not mandatory, integrating pricing can enhance the customer experience by providing up-to-date pricing during the booking process. This will allow to easily differentiate prices per day or timeslot.
Key Takeaways:
- Seamless Integration: These endpoints are essential for ensuring smooth communication between systems.
- Real-Time Updates: Bookings, reservations, and cancellations are accurately managed to provide a great customer experience.
- Optional Pricing Integration: Adding pricing to the flow can further improve supplier experience and satisfaction.
I only need to import bookings from the supplier account. Is there a specific endpoint for this?
The GetYourGuide integration requires a complete set of endpoints to function effectively. It is not possible to develop the integration solely to retrieve bookings or update availability independently; all mandatory functionalities must be implemented as part of the complete system. To ensure full integration, the following key endpoints must be developed:
- Availability Query
- Reservation (with a minimum holding time)
- Reservation Cancellation
- Booking
- Booking Cancellation
- Notify Availability
These mandatory endpoints are essential for managing your products, starting from the availability query through to successful booking. For more detailed information on these endpoints, please refer to our API Documentation.
What is the basic Flow for an Integration with GetYourGuide?
This integration aims to streamline the management of your activities on GetYourGuide, enabling seamless communication between your system and our platform. By establishing a robust connection, you will gain full control over availability, reservations, and bookings, ensuring a smooth experience for both your suppliers and their customers.
The flow involves GetYourGuide periodically querying availability for products, reserving quantities to initiate the booking process, and subsequently confirming the reservation to ensure successful bookings
To successfully create a system that integrates with GetYourGuide, you must develop all mandatory endpoints along with any additional, based on your specific needs. The mandatory endpoints include:
- Availability Query
- Reservation (with a minimum holding time)
- Reservation Cancellation
- Booking
- Booking Cancellation
- Availability Update Notification
These mandatory endpoints are essential for managing your activity on GetYourGuide, starting from the moment you provide us with availability to the moment you receive a booking. While all other endpoints are optional, they can only be implemented in addition to the mandatory ones.
Furthermore, the integration will occur at the option level. This means that for every option you have on GetYourGuide, your system will have a corresponding product ID linked to it.
For detailed requirements to integrate your system with our portal, please refer to our API Documentation .
Below, you will find a more comprehensive guide to our endpoints:
Are there any obligations on my side?
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
What happens when I sign up?
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
How and when do I get paid?
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Supplier resources on connectivity partners
Tips & Insights
Gain valuable knowledge to optimize your integration and boost performance through industry insights and best practices.
Walkthrough Videos
Step-by-step tutorials to simplify your onboarding process and make the most out of your partnership.
API Guides
Detailed documentation and technical guides to help you seamlessly integrate via APIs and streamline your operations.
FAQ’s
Access answers to frequently asked questions tailored specifically for Connectivity Partners and Suppliers.