GetYourGuide API and MCP server

• POST

  list_bookings

  Bookings for your products, by activity date, with travelers, option and status.

  read

  Returns bookings whose activity date falls in the range, ordered by date and start time. Cancelled bookings are left out unless status is cancelled or all. Results come in pages; pass next_cursor as cursor for the next one.

  POST /api/v1/getyourguide/list_bookings

  Input

  Input: list_bookings

  Parameter	Type	Description
  from	date	First activity date. Default: today.
  to	date	Last activity date. Default: 7 days from today.
  product_id	string	Only bookings for this product.
  status	enum	confirmed, cancelled or all. Default: confirmed.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "bookings": [
      {
        "booking_reference": "GYGZ4K2M9T1X",
        "product_id": "88213",
        "option_id": "412087",
        "date": "2026-10-18",
        "time": "17:30",
        "status": "confirmed",
        "travelers": {
          "adult": 2,
          "child": 1
        }
      },
      {
        "booking_reference": "GYGB7Q5N3R8D",
        "product_id": "88213",
        "option_id": "412087",
        "date": "2026-10-18",
        "time": "18:30",
        "status": "confirmed",
        "travelers": {
          "adult": 4,
          "child": 0
        }
      }
    ],
    "next_cursor": null
  }

• POST

  get_booking

  One booking: reference, option, date and time, participants by category, price and lead traveler.

  read

  Returns one booking with the option, date, start time, travelers per category, the price and the lead traveler's name and language. The reference is on the booking in list_bookings.

  POST /api/v1/getyourguide/get_booking

  Input

  Input: get_booking

  Parameter	Type	Description
  booking_reference required	string	GetYourGuide booking reference from list_bookings, e.g. GYGZ4K2M9T1X.

  Example response

  {
    "booking_reference": "GYGZ4K2M9T1X",
    "product": "Sunset Harbor Walking Tour",
    "option_id": "412087",
    "date": "2026-10-18",
    "time": "17:30",
    "status": "confirmed",
    "travelers": {
      "adult": 2,
      "child": 1
    },
    "price": {
      "amount": 110,
      "currency": "EUR"
    },
    "lead_traveler": {
      "name": "Sam Rivera",
      "language": "en"
    }
  }

• POST

  list_products

  Your products with their options, status and price categories.

  read

  Returns your products and, under each, its options with the option ID that the availability and pricing tools need. Each option lists its price categories and current retail prices. Inactive products are left out unless you ask.

  POST /api/v1/getyourguide/list_products

  Input

  Input: list_products

  Parameter	Type	Description
  status	enum	active, inactive or all. Default: active.

  Example response

  {
    "products": [
      {
        "product_id": "88213",
        "title": "Sunset Harbor Walking Tour",
        "status": "active",
        "options": [
          {
            "option_id": "412087",
            "name": "English, small group",
            "price_categories": {
              "adult": 40,
              "child": 20
            },
            "currency": "EUR"
          }
        ]
      }
    ]
  }

• POST

  get_availability

  Start times and free spots of an option for the dates you ask for.

  read

  Returns each date in the range with its start times, free spots and how many are booked. Use it before closing a slot to see who is already booked.

  POST /api/v1/getyourguide/get_availability

  Input

  Input: get_availability

  Parameter	Type	Description
  option_id required	string	Option ID from list_products.
  from required	date	First date.
  to required	date	Last date.

  Example response

  {
    "option_id": "412087",
    "days": [
      {
        "date": "2026-10-18",
        "slots": [
          {
            "time": "17:30",
            "vacancies": 8,
            "booked": 3
          },
          {
            "time": "18:30",
            "vacancies": 12,
            "booked": 0
          }
        ]
      }
    ]
  }

• POST

  list_messages

  Traveler conversations from Messages, each with its booking reference.

  read

  Returns your Messages conversations, most recent first, with the traveler, the booking reference, the unread count and the last message. Set unread_only to see only what needs an answer.

  POST /api/v1/getyourguide/list_messages

  Input

  Input: list_messages

  Parameter	Type	Description
  unread_only	boolean	Only conversations with unread messages. Default: false.
  limit	integer	1 to 50. Default: 20.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "cv_7a21",
        "booking_reference": "GYGZ4K2M9T1X",
        "traveler": "Sam Rivera",
        "unread": 1,
        "last_message": "Where exactly do we meet?",
        "updated_at": "2026-10-16T08:12:00Z"
      }
    ],
    "next_cursor": null
  }

• POST

  list_reviews

  Reviews of your products with rating, text, date and your reply, if any.

  read

  Returns reviews of your products, newest first, with rating, text, date and your reply when there is one. Filter to unanswered reviews to build a reply queue.

  POST /api/v1/getyourguide/list_reviews

  Input

  Input: list_reviews

  Parameter	Type	Description
  product_id	string	Only reviews of this product.
  since	date	Only reviews on or after this date.
  unanswered_only	boolean	Skip reviews you already replied to.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "reviews": [
      {
        "review_id": "rv_30482",
        "product_id": "88213",
        "rating": 5,
        "text": "Great guide, loved the harbor stories.",
        "date": "2026-10-12",
        "reply": null
      }
    ],
    "next_cursor": null
  }

• POST

  get_performance

  The figures shown in the Supplier Portal performance view, for a date range.

  read

  Returns the figures shown in the Supplier Portal performance view for the range. Without product_id every product is included.

  POST /api/v1/getyourguide/get_performance

  Input

  Input: get_performance

  Parameter	Type	Description
  from required	date	Start of the period.
  to required	date	End of the period.
  product_id	string	Only this product. Default: all products.

  Example response

  {
    "from": "2026-10-05",
    "to": "2026-10-11",
    "products": [
      {
        "product_id": "88213",
        "title": "Sunset Harbor Walking Tour",
        "figures": {
          "bookings": 37
        }
      }
    ]
  }

• POST

  update_availability

  Set free spots for start times of an option on one date, or close them with 0.

  write

  Sets free spots per start time for one option and one date; 0 closes the slot. Existing bookings are not touched. It reaches no one and one call reopens the slot, so it runs without asking for your OK. Returns the slots as the app now shows them.

  POST /api/v1/getyourguide/update_availability

  Input

  Input: update_availability

  Parameter	Type	Description
  option_id required	string	Option ID from list_products.
  date required	date	Activity date.
  slots required	object	Map of start time (HH:MM) to free spots, e.g. {"17:30": 0}.

  Example response

  {
    "option_id": "412087",
    "date": "2026-10-18",
    "slots": [
      {
        "time": "17:30",
        "vacancies": 0,
        "status": "closed"
      },
      {
        "time": "18:30",
        "vacancies": 0,
        "status": "closed"
      }
    ],
    "bookings_on_date": 3
  }

• POST

  update_pricing

  Change the retail price per category of an option, from a date on.

  asks first write

  Sets the retail price per price category of one option from a date on. Travelers see the new price on the activity page, so a wrong price costs money. A booking system that pushes rates can overwrite it. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/getyourguide/update_pricing

  Input

  Input: update_pricing

  Parameter	Type	Description
  option_id required	string	Option ID from list_products.
  prices required	object	Map of price category (adult, child) to price in your currency.
  valid_from	date	First date with the new price. Default: today.

  Example response

  {
    "option_id": "412087",
    "valid_from": "2026-11-01",
    "currency": "EUR",
    "prices": {
      "adult": 44,
      "child": 22
    },
    "previous": {
      "adult": 40,
      "child": 20
    }
  }

• POST

  reply_to_message

  Send a reply to a traveler in a Messages conversation.

  asks first write

  Sends your reply to the traveler in the conversation; it appears in their GetYourGuide app. Messages cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/getyourguide/reply_to_message

  Input

  Input: reply_to_message

  Parameter	Type	Description
  conversation_id required	string	Conversation ID from list_messages.
  body required	string	Reply text.

  Example response

  {
    "conversation_id": "cv_7a21",
    "status": "sent",
    "sent_at": "2026-10-16T08:40:00Z"
  }

• POST

  reply_to_review

  Post your public reply under a review of your product.

  asks first write

  Posts your reply under one review. It is public on the activity page and attached to your provider name. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/getyourguide/reply_to_review

  Input

  Input: reply_to_review

  Parameter	Type	Description
  review_id required	string	Review ID from list_reviews.
  body required	string	Reply text, shown publicly on the activity page.

  Example response

  {
    "review_id": "rv_30482",
    "status": "published",
    "replied_at": "2026-10-16T09:05:00Z"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.