Update bookingorder

PUT

/v1/bookingorders/{bookingorder_id}

update booking order. only update items no guests.

Authorizations

api_key

Type

API Key (header: X-Api-Key)

Parameters

Path Parameters

bookingorder_id*

XS2event ID of the Bookingorder

Type

string

Required

Query Parameters

sorting

Type

string

Default

null

mediation_fees

Whether to recalculate mediation fees

Type

boolean

Examplefalse

Default

false

payment_fees

Whether to recalculate payment fees

Type

boolean

Examplefalse

Default

false

booking_fees

Whether to recalculate webshop fee

Type

boolean

Examplefalse

Default

false

platform_service_fee

Whether to recalculate platform service fee

Type

boolean

Examplefalse

Default

false

should_delete_purchaseorder

When cancelling a relisting buyer bookingorder, also withdraw the relisting purchase order (credit the relister's supplier payout). When False, the relisting stays live and the payout is untouched.

Type

boolean

Examplefalse

Default

false

Request Body

application/json

{

  

"items": [

  

  

{

  

  

  

"activated": "2025-04-24T12:00:00",

  

  

  

"category_id": "7df2fbc7f06e4985be92fb263b1f9c63_ctg",

  

  

  

"category_name": "Gold Stand",

  

  

  

"currency": "EUR",

  

  

  

"distribution_channel": "xs2event",

  

  

  

"download_items": [

  

  

  

  

{

  

  

  

  

  

"download_link": "https://.../download.pdf",

  

  

  

  

  

"external_activation_link": "https://.../activate",

  

  

  

  

  

"ticket_sha": "abc123",

  

  

  

  

  

"downloaditem_id": "1bdae1eafa3b4ff2907f48637ee03095_dli",

  

  

  

  

  

"activated": "2025-04-24T12:00:00",

  

  

  

  

  

"label": "e-ticket"

  

  

  

  

}

  

  

  

],

  

  

  

"download_link": "https://.../download.pdf",

  

  

  

"external_activation_link": "https://.../activate",

  

  

  

"face_value": 5000,

  

  

  

"face_value_eur": 5500,

  

  

  

"face_value_local": 6000,

  

  

  

"face_value_target": 6500,

  

  

  

"guest": {

  

  

  

  

"first_name": "John",

  

  

  

  

"last_name": "Doe",

  

  

  

  

"passport_number": "ABC123456",

  

  

  

  

"contact_email": "[email protected]",

  

  

  

  

"contact_phone": "+31123456789",

  

  

  

  

"lead_guest": true,

  

  

  

  

"date_of_birth": "1991-01-30",

  

  

  

  

"gender": "male",

  

  

  

  

"country_of_residence": "NLD",

  

  

  

  

"street_name": "Hereweg 95",

  

  

  

  

"additional_street_name": "e",

  

  

  

  

"city": "Groningen",

  

  

  

  

"zip": "9721AA",

  

  

  

  

"province": "Groningen",

  

  

  

  

"supported_team": "Los Angeles Rams",

  

  

  

  

"guest_id": null,

  

  

  

  

"conditions": {

  

  

  

  

  

"additionalProperties": "string"

  

  

  

  

}

  

  

  

},

  

  

  

"local_currency": "USD",

  

  

  

"net_rate": 4000,

  

  

  

"orderitem_id": "f3c67de9087d48aa9a5b7aa4e2d75b01_oit",

  

  

  

"quantity": 2,

  

  

  

"row": "A",

  

  

  

"sales_price": 7000,

  

  

  

"sales_price_eur": 7500,

  

  

  

"sales_price_local": 8000,

  

  

  

"sales_price_target": 8500,

  

  

  

"salesprice": 7000,

  

  

  

"seat": "12",

  

  

  

"section": "East Wing",

  

  

  

"sub_category": "adult",

  

  

  

"target_currency": "USD",

  

  

  

"ticket_currency": "EUR",

  

  

  

"ticket_id": "a5cf8e7b39c14aeba4de30a8f67b9e23_tck",

  

  

  

"ticket_name": "VIP Ticket",

  

  

  

"ticket_sha": "abc123",

  

  

  

"ticket_startdate": "2025-01-01",

  

  

  

"ticket_status": "completed",

  

  

  

"ticket_stopdate": "2025-01-02",

  

  

  

"ticket_targetgroup": "regular",

  

  

  

"ticket_validity": "singleday",

  

  

  

"type_ticket": "eticket",

  

  

  

"number_of_pdfs": 1,

  

  

  

"costprice": 3000,

  

  

  

"updated": "2025-04-23T12:00:00",

  

  

  

"uploaded_at": "2025-04-22T12:00:00",

  

  

  

"cost_price": 3000,

  

  

  

"cost_price_eur": 3500,

  

  

  

"cost_price_local": 3700,

  

  

  

"cost_price_target": 3800,

  

  

  

"sales_price_eur_refund": 7500

  

  

}

  

],

  

"booking_id": "1b97adfc8a3a4fe4ad13b58f40372cca_bkn",

  

"booking_email": "[email protected]",

  

"distributor_id": "b05f667dcaa843bd8c171c522217eb81_dst",

  

"event_id": "dd82ecd6931749819942c4aff9dd23cb_evt",

  

"supplier_id": "7acfed7b0d874c5e870b531e5a4f0e43_spp",

  

"logistic_status": "processing",

  

"financial_status": "topurchase",

  

"distributorfinancial_status": "paid",

  

"guestdata_status": "completed",

  

"suppress_email": false,

  

"invoices": [

  

  

"string"

  

],

  

"invoice_reference": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d_inv",

  

"payment_reference": "8c4a2b9d123e4f5a876c5d4e3f2b1a09_pay",

  

"accepted_gt": true,

  

"marketing_optin": false,

  

"booking_group": [

  

  

[

  

  

  

"CODE_A",

  

  

  

"CODE_B"

  

  

]

  

],

  

"parent_id": "1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d_bkn",

  

"psp_refund_amount": 5000,

  

"lead_name_for_pickup": "John Doe"

}

Responses

OK

PUT

/v1/bookingorders/{bookingorder_id}

Playground

Server

Authorization

api_key

Variables

Key

Value

bookingorder_id*

sorting

mediation_fees

payment_fees

booking_fees

platform_service_fee

should_delete_purchaseorder

Body

Samples