1. Products

This endpoint returns the list of ticketing products (admissions) that are released for sale through third-party integrations for the API key's merchant.

Only admissions that have the Third party integrations sales channel enabled and that list the API key's user in their allow-list are returned.

GET https://api.e-guma.ch/v1/ticketing/products.json?apikey={api-key}

Parameters


api-key `required`	API key of a user that is approved for third-party integrations.

Return


company_name	Name of the merchant (company) the API key belongs to.
products	List of products, see product object below for details.

Product object


id	ID of the product. Use this value as the product_id in the List of Availabilities API, Reserve Tickets API and Book Tickets API.
name	Product name in the default language of the merchant.
description	Product description in the default language of the merchant. It can contain HTML.
is_active	`true` if the product is currently published. If `false`, the product cannot be booked. The product is still returned so you can keep it referenced in your system and re-activate it once the e-guma user publishes it again.
slot_type	Indicates the granularity of the availabilities returned by the List of Availabilities API: day: The product is booked on a per-day basis. The starts_at of each availability only carries a date (the time portion is always `00:00:00`). time: The product is booked on specific calendar slots. The starts_at of each availability carries a meaningful date and time.
updated_at	Moment at which the product was last modified in e-guma, in ISO 8601 format. You can use this value to keep your local cache in sync.
categories	List of person categories (e.g. Adult, Child) that can be purchased for this product. See person category object below for details. A product may be returned with an empty list of categories. In that case, no booking is currently possible through the API, but the product is still listed so you can keep it referenced in your system.

Person category object


id	ID of the person category. Use this value as the category_id in the Reserve Tickets API and Book Tickets API.
name	Name of the person category (e.g. Adult, Child).
age_from	Minimum age (in years) for this category, or `null` if there is no lower bound.
age_to	Maximum age (in years) for this category, or `null` if there is no upper bound.

Example

GET https://api.e-guma.ch/v1/ticketing/products.json?apikey=510e32c594d84816a4af9df1

{
  "company_name": "Demo",
  "products": [
    {
      "id": "64ad1bb1973b861c040c99bc",
      "name": "Museum admission",
      "description": "Admission ticket for the permanent exhibition.",
      "is_active": true,
      "slot_type": "day",
      "updated_at": "2026-03-15T14:22:05.0000000",
      "categories": [
        {
          "id": "64ad1bb1973b861c040c99c1",
          "name": "Adult",
          "age_from": 16,
          "age_to": null
        },
        {
          "id": "64ad1bb1973b861c040c99c2",
          "name": "Child",
          "age_from": 6,
          "age_to": 15
        }
      ]
    },
    {
      "id": "64ad1bb1973b861c040c99bd",
      "name": "Guided tour",
      "description": "Guided tour of the museum (90 min).",
      "is_active": true,
      "slot_type": "time",
      "updated_at": "2026-03-10T09:00:00.0000000",
      "categories": [
        {
          "id": "64ad1bb1973b861c040c99c1",
          "name": "Adult",
          "age_from": null,
          "age_to": null
        }
      ]
    }
  ]
}