In some cases, after the order is created, it will be necessary to enter beneficiary information to be able to download the PDF tickets.
Here is the workflow :
You can get this information when you retrieve the order. The fields order.items[].tickets[].requiredBeneficiaryFields contain the required fields you need to collect. Let's take the example below:
{
"@context": "/contexts/BookingOrder",
"@id": "/v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643",
"@type": "BookingOrder",
"id": "0197cb40-0a9a-772d-9c06-94f4ebf74643",
"createdAt": "2025-07-02T13:07:41+00:00",
"catalog": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5",
"organization": "/v1/organizations/0194d07e-aa39-71a8-9d45-bba145a85838",
"reference": "KTOLKT-84A749",
"externalReference": "TEST",
"connectorReference": "3875",
"totalAmountInclTax": "80.00",
"totalAmountExclTax": "75.83",
"reservation": "/v1/booking/reservations/0197cb3f-f1dd-7246-9660-d1613775333f",
"customer": {
"@type": "OrderCustomer",
"@id": "/.well-known/genid/659ea7d58fe6d29dcf2e",
"firstname": "test",
"lastname": "test",
"email": "[email protected]",
"phone": "0610203040",
"optin": false,
"country": "FR",
"language": "fr",
"title": "mx"
},
"status": "confirmed",
"cancelledAt": null,
"items": [
{
"@type": "OrderItem",
"@id": "/.well-known/genid/132ddf0cb624270e4245",
"unitAmountInclTax": "80.00",
"unitAmountExclTax": "75.83",
"quantity": 1,
"totalAmountInclTax": "80.00",
"totalAmountExclTax": "75.83",
"id": "0197cb40-0a99-7351-8a73-3278b4978671",
"amountInclTax": "80.00",
"amountExclTax": "75.83",
"date": "2026-01-18",
"product": "/v1/ticketing/catalogs/0196f2ef-c0de-7456-ac8e-8e2479c54aa5/products/0197c022-3988-7006-83a2-94a34daeec03",
"tickets": [
{
"@type": "OrderItemTicketResource",
"@id": "/v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643/items/0197cb40-0a99-7351-8a73-3278b4978671/tickets/0197cb40-0a99-7351-8a73-3278b40b0cbc",
"id": "0197cb40-0a99-7351-8a73-3278b40b0cbc",
"voucher": "8555400800002783",
"occursAt": "2026-01-18T21:00:00+01:00",
"requiredBeneficiaryFields": [
"firstname",
"lastname"
],
"beneficiary": null
}
]
}
],
"documents": [
"/v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643/documents/0197cb40-0a9a-772d-9c06-94f4ebf9f433"
]
}Here we can see that the ticket /v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643/items/0197cb40-0a99-7351-8a73-3278b4978671/tickets/0197cb40-0a99-7351-8a73-3278b40b0cbc requires the first and last name of the beneficiary. It will therefore be necessary to provide us with this information.
curl --request PATCH \
--url https://api.korusticket.com/v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643/items/0197cb40-0a99-7351-8a73-3278b4978671/tickets/0197cb40-0a99-7351-8a73-3278b40b0cbc \
-H 'accept: application/ld+json' \
-H 'Authorization: Bearer {{YOUR_JWT_TOKEN}}' \
-H 'Accept-Language: fr' \
-d '{"beneficiary":{"firstname":"Jane","lastname:"Doe"}}'{
"@context": "/contexts/BookingOrderItemTicket",
"@id": "/v1/booking/orders/0197cb40-0a9a-772d-9c06-94f4ebf74643/items/0197cb40-0a99-7351-8a73-3278b4978671/tickets/0197cb40-0a99-7351-8a73-3278b40b0cbc",
"@type": "BookingOrderItemTicket",
"id": "0197cb40-0a99-7351-8a73-3278b40b0cbc",
"voucher": "8553502600104675",
"occursAt": "2025-12-31T17:00:00+01:00",
"requiredBeneficiaryFields": [
"firstname",
"lastname"
],
"beneficiary": {
"@type": "OrderItemTicketBeneficiary",
"@id": "/.well-known/genid/5728fdea50ff65807db0",
"firstname": "Jane",
"lastname": "Doe",
"email": null,
"phone": null,
"title": null,
"dateOfBirth": null,
"placeOfBirth": null,
"nationality": null
},
"beneficiaryDesignationDeadline": "2025-12-31T17:30:00+00:00",
"beneficiaryAmendable": true,
"status": "validated",
"seating": []
}