Turn the GetYourGuide Supplier Portal into an API

What you can build on the Supplier Portal

• Get bookings

  Build this

  Reads the booking list in the Bookings section, filtered by Product, Activity Date or Reference code, with the details behind Show details.

  Takes

  Activity date from, activity date to, product (optional), reference code (optional)

  Returns

  Booking reference, booking date, activity date, product, participants, total retail price, currency, status, customer name, phone

• Get invoices with their booking lines

  Build this

  Reads Finance, Invoices: each invoice's number and status, and the bookings listed in its XLS booking list.

  Takes

  Issued since (optional), status (optional)

  Returns

  Invoice number, status, booking reference, activity date, currency, retail price, commission amount, retail price minus commission

• Get customer messages

  Build this

  Reads the conversations under Bookings, Messages, with the booking each one belongs to.

  Takes

  Received since (optional)

  Returns

  Booking reference, product, activity date, customer name, last message, received at

• Reply to a customer message

  Build this

  Opens the conversation for one booking under Bookings, Messages and sends your reply in the Portal.

  Takes

  Booking reference, reply text

  Returns

  Booking reference, reply sent, sent at

Automate the Supplier Portal with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Tomorrow's participant list for each product

  Build this

  Starts

  Every day at 18:00

  Step 1

  Get bookings with tomorrow's activity date.

  Step 2

  Keep the bookings that are not Canceled or Cancellation Requested.

  Step 3

  Email you the list grouped by product, with participants and customer names.

• New invoices handed to accounting

  Build this

  Starts

  Every weekday at 9:00

  Step 1

  Get the invoices in Finance, Invoices with their booking lines.

  Step 2

  Keep the invoices that were not there on the last run.

  Step 3

  Post invoice number, status and each booking line to your accounting system's webhook.

• Cancellations for the next 30 days

  Build this

  Starts

  Every hour

  Step 1

  Get bookings with an activity date in the next 30 days.

  Step 2

  Keep the ones whose status changed to Canceled or Cancellation Requested since the last run.

  Step 3

  Post booking reference, product, activity date and participants to your webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get bookings” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "supplier.getyourguide.com/get_bookings",
    "input": {
      "activity_date_from": "2026-11-13",
      "activity_date_to": "2026-11-13"
    }
  }'

{
  "status": "completed",
  "data": {
    "bookings": [
      {
        "booking_reference": "GYGX7K2LQ9PA",
        "booking_date": "2026-11-02",
        "activity_date": "2026-11-13T09:30",
        "product": "Acme Harbour Walking Tour, Morning option",
        "participants": 3,
        "total_retail_price": 135,
        "currency": "EUR",
        "status": "Confirmed",
        "customer_name": "Northwind traveller",
        "phone": "+49 30 0000 0000"
      }
    ]
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The Supplier Portal’s own options

GetYourGuide has a Supplier API for connectivity: your reservation system hosts endpoints that GetYourGuide calls for availability, reservations and bookings. It does not cover invoices, payment confirmations or messages. In the Supplier Portal you can download bookings, and each invoice and payment confirmation comes with a PDF and a spreadsheet of its bookings.

Read on November 12, 2026: Supplier API overview, Navigating the Bookings section, Invoice and payment confirmation.

Signing in to the Supplier Portal

The Supplier Portal signs you in with a password and requires two-factor authentication on every login, by authenticator app or SMS. GetYourGuide advises against shared accounts. With Fous you sign in through the Supplier Portal's own sign-in with your own account; the login is sealed with AES-256, and code and AI agents never see it.

Worth knowing

Customer details have a time window

All customer data, including phone and email, shows only for bookings up to 10 days in the past and one month ahead. For older bookings the Portal shows names for up to three months.

Invoices arrive on fixed days

Monthly suppliers get an invoice on the 1st business day of the month; bi-weekly suppliers also on the 16th. Invoice numbers start with GIS-, payment confirmations with GPS- or GS-.

Payment in Progress can take days

An invoice usually moves from Payment in Progress to Paid within 2 to 7 business days. It stays there if payment details are missing or while a negative invoice waits to be offset.

Bookings for Payout is not for everyone

The Bookings for Payout page in Finance, with Your Balance and Next Payout, applies only to suppliers paid by travel date. Suppliers paid by checkout date work from invoices and payment confirmations.

More in Travel and hospitality

• IATA BSPlink
• My ARC
• Amadeus Selling Platform Connect
• Travelport Smartpoint
• Alloggiati Web
• SES.Hospedajes
• Cvent Supplier Network
• Agoda YCS
• Booking.com Extranet
• Expedia Partner Central
• Trip.com eBooking
• Tripadvisor Management Centre
• Airbnb hosting dashboard
• Viator Supplier Center

Other industries: Oficina Virtual CCSS (SICERE), EmaraTax, e-ΕΦΚΑ, Planning Portal, Sunshine 811, HSBC UK for Intermediaries.