Introduction

This section provides practical use cases demonstrating the main API endpoints.

Authenticate

Visit the dedicated documentation page to learn how to authenticate with the Korus Ticket API

Http Requests

In the following sections every curl commands are executed with the following headers :

Authentication header containing the JWT token issued by the authentication endpoint
Accept-Language header that will set the language for all translated fields returned in http responses

Also, to simplify the examples curl GET commands returning list of elements will use the page and itemsPerPage pagination parameters to get a short and lisible response.

Catalog access

For the following sections your organization needs to have access to a catalog. To list catalogs accessible to your organization you can use the GET /v1/ticketing/catalogs endpoint.

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs \
  --header 'accept: application/ld+json' \
  --header 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  --header 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingCatalog",
  "@id": "/v1/ticketing/catalogs",
  "@type": "Collection",
  "totalItems": 1,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e",
      "@type": "TicketingCatalog",
      "id": "0194abdc-3a71-72b0-a9b9-89d4be0cd73e",
      "createdAt": "2025-01-28T07:42:04+00:00",
      "name": "Catalogue Puy du Fou - CSE"
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs?catalog=0193afd5-2ae2-78a9-866a-e4592fe5eba",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/v1/ticketing/catalogs{?}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": []
  }
}

The response shows that you have access to the "Catalogue Puy du Fou - CSE" catalog ️

Important

If no catalogs appear in the HTTP response, please contact Korusticket Support.