Skip to content
/
Browsing catalogs
Last updated

Browsing catalogs

Caching Strategy and API Usage

Please read this section.

We recommend using the following endpoints to fetch catalog data into your system and cache it for 24 hours.

List base products

Let's say we use the catalog ID 0196f2ef-c0de-7456-ac8e-8e2479c54aa5.

To get a list of catalog's base products, you can use the /v1/ticketing/catalogs/{id}/product_bases

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases\?page\=1\&itemsPerPage\=2 \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingProductBase",
  "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases",
  "@type": "Collection",
  "totalItems": 2,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0",
      "@type": "TicketingProductBase",
      "id": "0199570c-3380-7e12-9dcd-7cbe238e71f0",
      "name": "Saison 2025 - 2026 - Ligue 1 Uber Eats - OL / FC LORIENT",
      "disabled": false
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3741-7efd-b79e-88891146a6b9",
      "@type": "TicketingProductBase",
      "id": "0199570c-3741-7efd-b79e-88891146a6b9",
      "name": "Saison 2025 - 2026 - CLASSIC TOUR",
      "disabled": false
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases?limit=2",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases{?}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": []
  }
}

List product of a base

Let's choose the "Saison 2025 - 2026 - Ligue 1 Uber Eats - OL / FC LORIENT" base product with id 0199570c-3380-7e12-9dcd-7cbe238e71f0. To list products of this base, we can use the endpoint /v1/ticketing/catalogs/{id}/product_bases/{id}/products

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/products\
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingProduct",
  "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/products",
  "@type": "Collection",
  "totalItems": 8,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-6f74-7109-9dc0-7de6541daf52",
      "@type": "TicketingProduct",
      "id": "0199570c-6f74-7109-9dc0-7de6541daf52",
      "name": "L1 - CAT 1 - OL / FC LORIENT - TARIF ENFANT - OUEST BASSE 011",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-6f82-77c3-9fba-539181a023d8",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f82-77c3-9fba-539181a023d8",
            "label": "TARIF ENFANT"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-6f84-7628-bdad-3bd1b704288e",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f84-7628-bdad-3bd1b704288e",
            "label": "CAT 1"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-6f85-7b5b-bed3-1c9745dcab46",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f85-7b5b-bed3-1c9745dcab46",
            "label": "OUEST BASSE 011"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8d42-7064-b074-5f263c928c32",
      "@type": "TicketingProduct",
      "id": "0199570c-8d42-7064-b074-5f263c928c32",
      "name": "L1 - CAT 1 - OL / FC LORIENT - TARIF CSE - OUEST BASSE 011",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "label": "TARIF CSE"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-6f84-7628-bdad-3bd1b704288e",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f84-7628-bdad-3bd1b704288e",
            "label": "CAT 1"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-6f85-7b5b-bed3-1c9745dcab46",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f85-7b5b-bed3-1c9745dcab46",
            "label": "OUEST BASSE 011"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8dd3-79f7-b574-498b10abf67d",
      "@type": "TicketingProduct",
      "id": "0199570c-8dd3-79f7-b574-498b10abf67d",
      "name": "L1 - CAT 2 - OL / FC LORIENT - PLEIN TARIF - EST INTER 131",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-8dd9-7e94-9d0c-07b43974ece3",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dd9-7e94-9d0c-07b43974ece3",
            "label": "PLEIN TARIF"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "label": "CAT 2"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "label": "EST INTER 131"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8e5d-7766-ba98-46cb63797580",
      "@type": "TicketingProduct",
      "id": "0199570c-8e5d-7766-ba98-46cb63797580",
      "name": "L1 - CAT 2 - OL / FC LORIENT - TARIF ENFANT - EST INTER 131",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-6f82-77c3-9fba-539181a023d8",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f82-77c3-9fba-539181a023d8",
            "value": "TARIF ENFANT"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "value": "CAT 2"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "value": "EST INTER 131"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8ed6-70a5-ab35-c776dc3c14d0",
      "@type": "TicketingProduct",
      "id": "0199570c-8ed6-70a5-ab35-c776dc3c14d0",
      "name": "L1 - CAT 2 - OL / FC LORIENT - TARIF CSE - EST INTER 131",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "label": "TARIF CSE"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dd9-7e94-9d0c-07b43a5c158d",
            "label": "CAT 2"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dda-715a-b5b4-9c03e9910a8a",
            "label": "EST INTER 131"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8f5a-7e8d-bc80-135f8f4ef0c4",
      "@type": "TicketingProduct",
      "id": "0199570c-8f5a-7e8d-bc80-135f8f4ef0c4",
      "name": "L1 - CAT 3 - OL / FC LORIENT - PLEIN TARIF - EST INTER 132",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-8dd9-7e94-9d0c-07b43974ece3",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8dd9-7e94-9d0c-07b43974ece3",
            "label": "PLEIN TARIF"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8f5f-7db5-8c76-6021d952b69f",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f5f-7db5-8c76-6021d952b69f",
            "label": "CAT 3"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8f60-7b06-86e7-56319596a3bb",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f60-7b06-86e7-56319596a3bb",
            "label": "EST INTER 132"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-8fd0-7cf1-b935-192857bf5d5c",
      "@type": "TicketingProduct",
      "id": "0199570c-8fd0-7cf1-b935-192857bf5d5c",
      "name": "L1 - CAT 3 - OL / FC LORIENT - TARIF ENFANT - EST INTER 132",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-6f82-77c3-9fba-539181a023d8",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-6f82-77c3-9fba-539181a023d8",
            "label": "TARIF ENFANT"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8f5f-7db5-8c76-6021d952b69f",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f5f-7db5-8c76-6021d952b69f",
            "label": "CAT 3"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8f60-7b06-86e7-56319596a3bb",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f60-7b06-86e7-56319596a3bb",
            "label": "EST INTER 132"
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-9056-70e8-99bb-f865148ec0f0",
      "@type": "TicketingProduct",
      "id": "0199570c-9056-70e8-99bb-f865148ec0f0",
      "name": "L1 - CAT 3 - OL / FC LORIENT - TARIF CSE - EST INTER 132",
      "description": "",
      "disabled": false,
      "options": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type",
          "@type": "TicketingProductBaseOption",
          "code": "price_type",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/price_type/values/0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8d4d-79e2-87d1-94f74ed4edc7",
            "label": "TARIF CSE"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category",
          "@type": "TicketingProductBaseOption",
          "code": "category",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/category/values/0199570c-8f5f-7db5-8c76-6021d952b69f",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f5f-7db5-8c76-6021d952b69f",
            "label": "CAT 3"
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone",
          "@type": "TicketingProductBaseOption",
          "code": "zone",
          "value": {
            "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values/0199570c-8f60-7b06-86e7-56319596a3bb",
            "@type": "TicketingProductBaseOptionValueResource",
            "id": "0199570c-8f60-7b06-86e7-56319596a3bb",
            "label": "EST INTER 132"
          }
        }
      ]
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/products",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/products{?}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": []
  }
}

There are eight products derived from the base product. Each product from a base defines specific values for each of the base's options in the options property.

Note: Every product derived from a base defines a value for each option.

You can use the options as categories to structure the product catalog data in your model or to organize your shop UI.

List base's options

A base can define zero or more options. To list a base's options, we use the /v1/ticketing/catalogs/{catalogId}/product_bases/{id}/options endpoint.

List option value

To list available option's values, we can use the /v1/ticketing/catalogs/{catalogId}/product_bases/{productBaseId}/options/{code}/values endpoint.

Taking the preceding JSON response, we could do the following request to ask for available zones :

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/product_bases/0199570c-3380-7e12-9dcd-7cbe238e71f0/options/zone/values \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Available options

Here is the available list of options:

  • days_count (Access Duration): Defines the number of access days granted by the product.
  • price_type (Price Category): Defines the product's pricing category (e.g., full price, reduced, student).
  • seating_category (Seating Category): Defines the type of seating granted by the product (e.g., seated, standing, VIP).
  • zone (Geographic Zone): Defines the geographic location within the venue where the event takes place.

The list of available options is predefined by the Korus system, and we could add options in the future. However, the possible values for each option are dynamic and depend on the underlying ticketing systems.

List product offers

An Offer is dated and specifies the price, availability, tickets granted by the product, and the available sessions for each ticket that can be selected during reservation.

To list a product's offers, we use the GET /v1/ticketing/catalogs/{catalogId}/offers endpoint as follows:

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers\?product[]=0199570c-9056-70e8-99bb-f865148ec0f0?\&page\=1\&itemsPerPage\=2 \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingOffer",
  "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers",
  "@type": "Collection",
  "totalItems": 1,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers/0199570c-9a9c-7619-89a7-d7d1db276ce7",
      "@type": "TicketingOffer",
      "id": "0199570c-9a9c-7619-89a7-d7d1db276ce7",
      "date": "2025-12-31",
      "expiresAt": "2025-12-31T20:00:00+01:00",
      "availabilityCheckRequired": true,
      "availableQuantity": null,
      "realtimePriceRequired": false,
      "price": {
        "@type": "OfferPrice",
        "@id": "/.well-known/genid/7298e93032cd69e518f0",
        "amountInclTax": "48.00",
        "originalAmountInclTax": "48.00",
        "currency": "EUR"
      },
      "product": {
        "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0199570c-9056-70e8-99bb-f865148ec0f0",
        "@type": "TicketingProduct",
        "id": "0199570c-9056-70e8-99bb-f865148ec0f0",
        "name": "L1 - CAT 3 - OL / FC LORIENT - TARIF CSE - EST INTER 132",
        "description": "",
        "disabled": false
      },
      "tickets": [
        {
          "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers/0199570c-9a9c-7619-89a7-d7d1db276ce7/tickets/0199570c-9a9c-7619-89a7-d7d1dc12aa67",
          "@type": "TicketingOfferTicket",
          "id": "0199570c-9a9c-7619-89a7-d7d1dc12aa67",
          "name": "OL / FC LORIENT",
          "description": "",
          "dateAccess": false,
          "sessions": [
            {
              "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers/0199570c-9a9c-7619-89a7-d7d1db276ce7/tickets/0199570c-9a9c-7619-89a7-d7d1dc12aa67/sessions/0199570c-9a9d-7718-8e12-042cc0530540",
              "@type": "TicketingOfferTicketSession",
              "id": "0199570c-9a9d-7718-8e12-042cc0530540",
              "occursAt": "2025-12-31T17:00:00+01:00",
              "duration": 120
            }
          ],
          "form": null
        }
      ]
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers?itemsPerPage=2&product%5B%5D=0199570c-9056-70e8-99bb-f865148ec0f0",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/offers{?product}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": [
      {
        "@type": "IriTemplateMapping",
        "variable": "product",
        "property": "product",
        "required": false
      }
    ]
  }
}

In this response we have the following information:

  • there is only one offer
  • this offer contains one ticket, and the ticket has one session.
  • the field "availabilityCheckRequired"=true indicates that the offer has a limited capacity. You can check the offer's real-time availability before reserving. Read this section for more details.
  • the field “realtimePriceRequired"=false indicates that the price returned will not change. For realtime price, refer to this section for more details.
Previous page
Next page