Skip to content

KorusTicket API (1.0.19)

KorusTicket API documentation

Download OpenAPI description
Languages
Servers
Demo server
https://api.demo.korusticket.com/
Production server
https://api.korusticket.com/

BookingOrderDocument

The files associated to the Order. These are typically the customer's tickets for the Event.

Operations

Retrieves the collection of BookingOrderDocument resources.

Request

Retrieves the collection of BookingOrderDocument resources.

Security
JWT
Path
orderIdstring[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0...required

Order identifier

curl -i -X GET \
  'https://api.demo.korusticket.com/v1/booking/orders/{orderId}/documents' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

BookingOrderDocument collection

Bodyapplication/ld+json
totalItemsinteger>= 0
searchobject
memberArray of objects(BookingOrderDocument.jsonld-v1.order_document.get)required
member[].​@contextstring or object
One of:
string
member[].​@idstringrequired
member[].​@typestringrequired
member[].​idstring
Example: "0194ad2c-491c-7c9e-b842-10ee940ed6a3"
member[].​downloadableAtstring(date-time)
Example: "2025-01-27T15:15:20+00:00"
Response
application/ld+json
{ "totalItems": 0, "search": { "@type": "string", "template": "string", "variableRepresentation": "string", "mapping": [] }, "member": [ {} ] }

Retrieves a BookingOrderDocument resource.

Request

Retrieves a BookingOrderDocument resource.

Security
JWT
Path
orderIdstring[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0...required

Order identifier

idstring[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0...required

Order Document identifier

curl -i -X GET \
  'https://api.demo.korusticket.com/v1/booking/orders/{orderId}/documents/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

BookingOrderDocument resource

Bodyapplication/ld+json
@contextstring or object
One of:
string
@idstringrequired
@typestringrequired
idstring
Example: "0194ad2c-491c-7c9e-b842-10ee940ed6a3"
downloadableAtstring(date-time)
Example: "2025-01-27T15:15:20+00:00"
Response
application/ld+json
{ "@context": "string", "@id": "string", "@type": "string", "id": "0194ad2c-491c-7c9e-b842-10ee940ed6a3", "downloadableAt": "2025-01-27T15:15:20+00:00" }

Updates the BookingOrderDocument resource.

Request

Updates the BookingOrderDocument resource.

Security
JWT
Path
orderIdstring[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0...required

Order identifier

idstring[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0...required

Order Document identifier

Bodyapplication/merge-patch+jsonrequired

The updated BookingOrderDocument resource

object(BookingOrderDocument.PatchOrderDocumentInput-v1.order_document.patch_write.jsonMergePatch)

The files associated to the Order. These are typically the customer's tickets for the Event.

curl -i -X PATCH \
  'https://api.demo.korusticket.com/v1/booking/orders/{orderId}/documents/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/merge-patch+json' \
  -d '{}'

Responses

BookingOrderDocument resource updated

Bodyapplication/ld+json
@contextstring or object
One of:
string
@idstringrequired
@typestringrequired
idstring
Example: "0194ad2c-491c-7c9e-b842-10ee940ed6a3"
temporaryUrlstring or null
Example: "https://storage.googleapis.com/BUCKET/0194a854-daf4-78fc-aed1-b39a0867add7/0194b6c7-cbc8-7e79-b8a8-e95ffd98d08f/0194b6c7-cbc8-7e79-b8a8-e95ffe2acb49.pdf?GoogleAccessId=bucket%40bucket.iam.gserviceaccount.com&Expires=1738235339&Signature=KG27A%2Bc4z6C2McDcT4G3H70dZpp5ED7wsQawE2Q8qbeABJcWpNy7xd5fneTx%2BXLzzf0QBv8wfqVvl8tNKwyK1EFnvq%2FDwtt6OtjAwnObFZtRB4X6eHuVoVR%2FR%2FT9JznN6okNc7KC5lLTYFDUkH%2Fh7M6mQ35wrtSJ6WCFv1Zf7LaPIhubLK9%2BBEfnziLbRAph4U5XJBGf4Xa5zGJtRqArNON5Ivs0f95L6MXZ4Aft%2BhByW%2Bllq9z7T9cJJAErDWYRDQotiUGmR4AOZ3D25k1CeNf8EN3ORjYNwboxGp5S43toNxswhZlMapBqoFyNC8oHVrg7eCbwsVxEUnc%2FiTt%2Fyw%3D%3D"
downloadableAtstring(date-time)
Example: "2025-01-27T15:15:20+00:00"
Response
application/ld+json
{ "@context": "string", "@id": "string", "@type": "string", "id": "0194ad2c-491c-7c9e-b842-10ee940ed6a3", "temporaryUrl": "https://storage.googleapis.com/BUCKET/0194a854-daf4-78fc-aed1-b39a0867add7/0194b6c7-cbc8-7e79-b8a8-e95ffd98d08f/0194b6c7-cbc8-7e79-b8a8-e95ffe2acb49.pdf?GoogleAccessId=bucket%40bucket.iam.gserviceaccount.com&Expires=1738235339&Signature=KG27A%2Bc4z6C2McDcT4G3H70dZpp5ED7wsQawE2Q8qbeABJcWpNy7xd5fneTx%2BXLzzf0QBv8wfqVvl8tNKwyK1EFnvq%2FDwtt6OtjAwnObFZtRB4X6eHuVoVR%2FR%2FT9JznN6okNc7KC5lLTYFDUkH%2Fh7M6mQ35wrtSJ6WCFv1Zf7LaPIhubLK9%2BBEfnziLbRAph4U5XJBGf4Xa5zGJtRqArNON5Ivs0f95L6MXZ4Aft%2BhByW%2Bllq9z7T9cJJAErDWYRDQotiUGmR4AOZ3D25k1CeNf8EN3ORjYNwboxGp5S43toNxswhZlMapBqoFyNC8oHVrg7eCbwsVxEUnc%2FiTt%2Fyw%3D%3D", "downloadableAt": "2025-01-27T15:15:20+00:00" }

BookingOrderItemTicket

A ticket is a single ticket for an OrderItem. A ticket is issued by the OrderItem's Order.

Operations

BookingOrder

An Order is an actual booking in the ticket issuer's system.

Operations

BookingReservation

A reservation temporarily holds an Offer, guaranteeing its availability and price for a limited time in the ticket issuer's system.

Operations

TicketingCatalog

A Catalog is the ticket issuer's collection of products and events. There is usually only one Catalog per TicketIssuer.

Operations

TicketingOffer

It is the price table of a product. Offers defines the price and availability of a Product at a specific date.

Operations

TicketingOfferAvailability

Ticket availability

Operations
Operations

TicketingOfferTicket

The tickets contained in an Offer. A tickets give access to an Event's sessions.

Operations

TicketingOfferTicketSession

OfferTicketSession represents the time slot of an OfferTicket.

Operations

TicketingProductBaseOption

Product Base available option

Operations

TicketingProductBaseOptionValue

Product Base available option values

Operations

TicketingProductBase

Product Base are the main elements of a catalog. They allow to group related products. They contain option with values that can be used to filter products.

Operations

TicketingProduct

Products are elements that can be purchased. The price and availability of a product at specific date and for a specific category are specified in the Offer object.

Operations