How to
/
Book a ticket with a specific Product
Last updated

Book a ticket with a specific Product

Workflow

1. Let's find a product

Let's say we use the catalog ID 0194abdc-3a71-72b0-a9b9-89d4be0cd73e.

To obtain a list of catalog's products you can use the /v1/ticketing/catalogs/{id}/products endpoint:

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products\?page\=1\&itemsPerPage\=2 \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingProduct",
  "@id": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products",
  "@type": "Collection",
  "totalItems": 65,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/{catalogId}/products/0194abfe-1bdb-7b12-af59-ad81ae443689",
      "@type": "TicketingProduct",
      "id": "0194abfe-1bdb-7b12-af59-ad81ae443689",
      "name": "Puy du Fou 1 jour Adulte",
      "description": "Le tarif « Sur réservation » s’applique jusqu’à 72 heures avant la date de visite indiquée lors de la réservation, dans la limite des places disponibles. Les billets sont valables uniquement aux dates de visite réservées. Adulte à partir de 14 ans.<br>"
    },
    {
      "@id": "/v1/ticketing/catalogs/{catalogId}/products/0194abfe-1c04-7ade-9bc3-dbcfefb12652",
      "@type": "TicketingProduct",
      "id": "0194abfe-1c04-7ade-9bc3-dbcfefb12652",
      "name": "Puy du Fou 1 jour Adulte + Cinéscénie Argent",
      "description": "<span style=\"color: rgb(29, 29, 27); font-family: Inter, sans-serif;\">Les tarifs \" Puy du Fou + Cinéscénie \" s'appliquent uniquement sur réservation, dans la limite des places disponibles. Les billets sont valables uniquement à la date de visite réservée. Adulte à partir de 14 ans.</span>"
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products?catalog=0193bb1c-ead0-7008-9cc6-39020058a84b&itemsPerPage=2&page=1",
    "@type": "PartialCollectionView",
    "first": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products?catalog=0193bb1c-ead0-7008-9cc6-39020058a84b&itemsPerPage=2&page=1",
    "last": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products?catalog=0193bb1c-ead0-7008-9cc6-39020058a84b&itemsPerPage=2&page=33",
    "next": "/v1/ticketing/catalogs/0194abdc-3a71-72b0-a9b9-89d4be0cd73e/products?catalog=0193bb1c-ead0-7008-9cc6-39020058a84b&itemsPerPage=2&page=2"
  }
}

We can see in the response that there is 65 products ("totalItems": 65) in the catalog.

You can use the paginations parameter to iterate through the list.

If you need more information about paginations, refer to this page

Let’s choose the product with ID 0194abfe-1c04-7ade-9bc3-dbcfefb12652.

2. Choose a product Offer at a specific Date

To find an offer corresponding to our chosen product for the specific date 2025-06-07 we can use the GET /v1/ticketing/catalogs/{catalogId}/offers endpoint as follows:

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/{catalogId}/offers\?product=0194abfe-1c04-7ade-9bc3-dbcfefb12652\&date=2025-06-07\&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/{catalogId}/offers",
  "@type": "Collection",
  "totalItems": 1,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894",
      "@type": "TicketingOffer",
      "id": "0194ac40-fda7-78c1-8fcb-26fc2df25894",
      "date": "2025-06-07",
      "availableQuantity": 1500,
      "realtimePriceRequired": false,
      "price": {
        "@type": "TicketingOfferPrice",
        "@id": "/.well-known/genid/7a820a778b28cb765bc6",
        "amountInclTax": "87.00",
        "originalAmountInclTax": "87.00",
        "currency": "EUR",
        "syncAt": "2025-01-28T09:32:07+00:00"
      },
      "product": {
        "@id": "/v1/ticketing/catalogs/{catalogId}/products/0194abfe-1c04-7ade-9bc3-dbcfefb12652",
        "@type": "TicketingProduct",
        "id": "0194abfe-1c04-7ade-9bc3-dbcfefb12652",
        "name": "Puy du Fou 1 jour Adulte + Cinéscénie Argent",
        "description": "<span style=\"color: rgb(29, 29, 27); font-family: Inter, sans-serif;\">Les tarifs \" Puy du Fou + Cinéscénie \" s'appliquent uniquement sur réservation, dans la limite des places disponibles. Les billets sont valables uniquement à la date de visite réservée. Adulte à partir de 14 ans.</span>"
      },
      "tickets": [
        {
          "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
          "@type": "TicketingOfferTicket",
          "id": "0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
          "name": "Puy du Fou Adulte",
          "description": ""
        },
        {
          "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda8-739e-8d03-57f30adf4660",
          "@type": "TicketingOfferTicket",
          "id": "0194ac40-fda8-739e-8d03-57f30adf4660",
          "name": "Cinéscénie Adulte - Argent",
          "description": ""
        }
      ]
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/{catalogId}/offers?date=2025-06-07&order%5Bdate%5D=asc&product=0194abfe-1c04-7ade-9bc3-dbcfefb12652",
    "@type": "PartialCollectionView"
  },
  "search": {
    "@type": "IriTemplate",
    "template": "/v1/ticketing/catalogs/{catalogId}/offers{?date,product}",
    "variableRepresentation": "BasicRepresentation",
    "mapping": [
      {
        "@type": "IriTemplateMapping",
        "variable": "date",
        "property": "date",
        "required": false
      },
      {
        "@type": "IriTemplateMapping",
        "variable": "product",
        "property": "product",
        "required": false
      }
    ]
  }
}

In this response we have the following information:

  • there is only one offer
  • this offer contains two tickets
  • the field "availableQuantity"=1500 indicates that the offer has a limited capacity. Offers with unlimited have availableQuantity=null. You can check the offer's real-time availability before calling the reservation. 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.

3. Select a session for each ticket

Each offer's ticket must be associated with a session in order to create a reservation.

To list the sessions available for each ticket, use the GET /v1/ticketing/catalogs/{catalogId}/offers/{offerId}/tickets endpoint.

Request

curl --request GET \
  --url https://api.korusticket.com/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr'

Response

{
  "@context": "/contexts/TicketingOfferTicket",
  "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets",
  "@type": "Collection",
  "totalItems": 2,
  "member": [
    {
      "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
      "@type": "TicketingOfferTicket",
      "id": "0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
      "name": "Puy du Fou Adulte",
      "description": "",
      "sessions": [
        {
          "@id": "/v1/ticketing/catalogs/{catalogId}/events/0194abfe-158a-7254-8ed7-35404c1c9b0b/sessions/0194abfe-1591-7e14-a7a4-c24008faa43d",
          "@type": "TicketingSession",
          "id": "0194abfe-1591-7e14-a7a4-c24008faa43d",
          "occursAt": "2025-06-07T00:00:00+02:00",
          "duration": null,
          "availableQuantity": 35000,
          "event": {
            "@id": "/v1/ticketing/catalogs/{catalogId}/events/0194abfe-158a-7254-8ed7-35404c1c9b0b",
            "@type": "TicketingEvent",
            "id": "0194abfe-158a-7254-8ed7-35404c1c9b0b",
            "name": "Billetterie - Puy du Fou",
            "description": ""
          }
        }
      ]
    },
    {
      "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/7522b8de-37a2-458d-b099-6d515b0739be",
      "@type": "TicketingOfferTicket",
      "id": "7522b8de-37a2-458d-b099-6d515b0739be",
      "name": "Cinéscénie Adulte - Argent",
      "description": "",
      "sessions": [
        {
          "@id": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/ff23a5a2-a53f-43b9-a530-d84a61386449",
          "@type": "TicketingSession",
          "id": "ff23a5a2-a53f-43b9-a530-d84a61386449",
          "occursAt": "2025-06-07T17:00:00+02:00",
          "duration": null,
          "availableQuantity": 24,
          "event": {
            "@id": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381",
            "@type": "TicketingEvent",
            "id": "2aa6ca51-5193-47db-9e27-0aeefdc0d381",
            "name": "Cinéscénie Adulte - Argent",
            "description": ""
          }
        },
        {
          "@id": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/337177bc-e513-444f-bcee-49a3e25b48a3",
          "@type": "TicketingSession",
          "id": "337177bc-e513-444f-bcee-49a3e25b48a3",
          "occursAt": "2025-06-07T20:00:00+02:00",
          "duration": null,
          "availableQuantity": 56,
          "event": {
            "@id": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381",
            "@type": "TicketingEvent",
            "id": "2aa6ca51-5193-47db-9e27-0aeefdc0d381",
            "name": "Cinéscénie Adulte - Argent",
            "description": ""
          }
        }
      ]
    }
  ],
  "view": {
    "@id": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets?catalog=0193b4e1-a0d5-7b21-a8e5-602c156a8914",
    "@type": "PartialCollectionView"
  }
}

In this response we have the following information:

  • the ticket of id 0194ac40-fda7-78c1-8fcb-26fc2e2612d4 that gives access to the Event Billetterie - Puy du Fou has only one session available
  • the ticket of id 7522b8de-37a2-458d-b099-6d515b0739be that gives access to the Event Cinéscénie Adulte - Argent has two sessions available. You will need to choose one to create the reservation.
  • Additionally, every session have a non-null "availableQuantity" value, meaning that sessions have a limited capacity. Session with unlimited capacity have "availableQuantity"=null. If you want you can check the real-time availability value before making a reservation. Refer to this section for more details.

4. Create the reservation

Creating a reservation temporarily holds an offer, guaranteeing its availability and price for a limited time.

Request Body - Ticket/Session association

To create the reservation you can use the POST /v1/booking/reservations/_bulk endpoint by passing the following JSON body:

{
  "items": [
    {
      "quantity": 1,
      "offer": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894",
      "ticketSessions": [
        {
          "ticket": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
          "session": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/ff23a5a2-a53f-43b9-a530-d84a61386449"
        },
        {
          "ticket": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/7522b8de-37a2-458d-b099-6d515b0739be",
          "session": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/337177bc-e513-444f-bcee-49a3e25b48a3"
        }
      ]
    }
  ]
}

For the first ticket, we choose the only available session, which has the ID 337177bc-e513-444f-bcee-49a3e25b48a3.

For the second ticket we choose the session that occurs at 2025-06-07T20:00:00+02:00.

Request

curl --request POST \
  --url https://api.korusticket.com/v1/booking/reservations/_bulk \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
  -H 'Accept-Language: fr' \
  -d '{"items":[{"quantity":1,"offer":"/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894","ticketSessions":[{"ticket":"/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda7-78c1-8fcb-26fc2e2612d4","session":"/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/0194abfe-1591-7e14-a7a4-c24008faa43d"},{"ticket":"/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/7522b8de-37a2-458d-b099-6d515b0739be","session":"/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/337177bc-e513-444f-bcee-49a3e25b48a3"}]}]}'

Response

{
  "@context": {
    "@vocab": "https://api.demo.korusticket.com/docs.jsonld#",
    "hydra": "http://www.w3.org/ns/hydra/core#",
    "reservations": "CreateReservationBulkOutput/reservations",
    "failedReservations": "CreateReservationBulkOutput/failedReservations"
  },
  "@type": "CreateReservationBulkOutput",
  "@id": "/.well-known/genid/78651cc4640b9253b7c0",
  "reservations": [
    {
      "@id": "/v1/booking/reservations/35e72d9b-0fdc-44e3-869c-e1781c14418e",
      "@type": "BookingReservation",
      "expired": false,
      "id": "35e72d9b-0fdc-44e3-869c-e1781c14418e",
      "createdAt": "2025-01-29T07:55:53+00:00",
      "totalAmountInclTax": "80.00",
      "totalAmountExclTax": null,
      "expiresAt": "2025-01-29T08:10:53+00:00",
      "items": [
        {
          "@type": "ReservationItem",
          "@id": "/.well-known/genid/dbb1fda993fdc977bbab",
          "unitAmountInclTax": "42.32",
          "unitAmountExclTax": null,
          "quantity": 1,
          "totalAmountInclTax": "42.32",
          "totalAmountExclTax": null,
          "offer": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894",
          "product": "/v1/ticketing/catalogs/{catalogId}/products/0194abfe-1c04-7ade-9bc3-dbcfefb12652",
          "offerTickets": [
            {
              "@type": "ReservationItemOfferTicket",
              "@id": "/.well-known/genid/6fef51eaef68c943a2de",
              "ticket": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/0194ac40-fda7-78c1-8fcb-26fc2e2612d4",
              "session": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/ff23a5a2-a53f-43b9-a530-d84a61386449"
            },
            {
              "@type": "ReservationItemOfferTicket",
              "@id": "/.well-known/genid/567f51eaef68c943aaa",
              "ticket": "/v1/ticketing/catalogs/{catalogId}/offers/0194ac40-fda7-78c1-8fcb-26fc2df25894/tickets/7522b8de-37a2-458d-b099-6d515b0739be",
              "session": "/v1/ticketing/catalogs/{catalogId}/events/2aa6ca51-5193-47db-9e27-0aeefdc0d381/sessions/337177bc-e513-444f-bcee-49a3e25b48a3"
            }
          ]
        }
      ],
      "organization": "/v1/ticketing/organizations/0194abdc-3a79-7ec3-b1b9-a1f291de587d",
      "order": null
    }
  ],
  "failedReservations": []
}

The response contains two arrays :

  • the “reservations” array contains the successful reservations
  • the "failedReservations" array contains offers that failed to be reserved

The "expiresAt" indicates when the reservation expires. After this timestamp, the offer will be released and the reservation will become invalid for booking.

5. Create the Order

For creating the Order you can refer to this section as it is exactly the same process.

Previous page
Next page