Create new reservations

Request

You can pass multiple offer item to reserve.

Items Attributes detail

Offer

The offer to reserve.

Quantity

The quantity of offer to reserve.

TicketSessions

Maps each ticket to its selected session.

Examples of form's fields values

for a text field : "M. Doe"
for a bool field : "true" or "false",
for a integer field : "3",
for a decimal field : "2.99",
for date field : "2025-01-01",
for a time field : "07:30",
for a datetime field : "2025-01-01 00:00:00,
for a single_choice or multi_choice field you must pass any of the predefined values.

Security

JWT

Bodyapplication/ld+jsonrequired

The new BookingReservation resource

itemsArray of objects, non-empty(OfferReservationInput-v1.reservation.create_bulk_write)

externalReferencestring or null, <= 255 characters

curl -i -X POST \
  https://api.demo.korusticket.com/v1/booking/reservations/_bulk \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/ld+json' \
  -d '{
    "items": [
      {
        "offer": "https://example.com/",
        "quantity": 1,
        "ticketSessions": [
          {
            "ticket": "https://example.com/",
            "session": "https://example.com/",
            "formData": {
              "form": "/v1/forms/0195197f-7918-7285-bb4b-7df2b682c3eb",
              "fields": [
                {
                  "field": "/v1/forms/01953871-e6dd-7f75-8c2d-39a2dd122b22/fields/01953871-e6df-7135-bd6c-ebe655262810",
                  "value": "Doe"
                }
              ]
            },
            "seats": [
              "string"
            ]
          }
        ]
      }
    ],
    "externalReference": "string"
  }'

Responses

BookingReservation resource created

Bodyapplication/ld+json

@contextstring or object

One of:

string

@idstringrequired

@typestringrequired

reservationsArray of objects(BookingReservation.jsonld-v1.reservation.create_bulk_read)required

failedReservationsArray of objects(FailedReservation.jsonld-v1.reservation.create_bulk_read)required

Response

{
  "@context": "string",
  "@id": "string",
  "@type": "string",
  "reservations": [
    { … }
  ],
  "failedReservations": [
    { … }
  ]
}