Create order

Creates a non-confirmed order (reservation) that expires after 30 minutes. To confirm an already created order, use the Confirm Order endpoint.

Order creation may fail validation for reasons such as insufficient availability, invalid/missing customer data or if we were unable to generate a reservation on the supplier's booking platform.

Also see Error Codes

In order to use the Booking API, please make sure to refer to our guide on how to Sign your API requests to our standard. JWT Signing for Secure API Requests

Ticket Language

By default, emails sent to the customers by Tiqets as well as the PDF tickets are made available in English. It is possible to set the language to any of the supported Tiqets languages by using the query parameter `lang`.

We recommend using the parameter if the customer has a preferred language different to English. By setting the language to the customer's preferred language, you make sure that the customer receives all relevant details in a language they understand.

Creating orders with external reference

The Tiqets Distributor API allows partners to add their own order reference ID (external reference) when creating orders. This external reference will be added in Tiqets' order system to help partners:

• Cross-reference orders from a partner's system to Tiqets' orders

• Handle errors in case of timeout or other errors during the order creation

The external reference ID's max. length is 255 characters and must be unique. Attempting to re-use an external reference ID will result in a unique constraint error response.

In case of timeouts or other errors during order creation, the own reference ID can be used to check the order status using the 'Get Order Information' endpoint.

Order Status Change Notification Webhook

The optional callback_url parameter can be used to provide a URL on your systems that we will call to inform you the status of this order has changed.

For more info: See the webhook's specific documentation.

Create order

post

https://api.tiqets.com/v2https://api-tiqt-test.steq.it/v2https://api.api-tiqt-test.steq.it/v2

/orders

Query parameters

langstringOptional

Language of the variants to retrieve.

Example: en

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Body

application/json

product_idintegerRequired

ID of the product

daystring · dateRequired

Visit date of the product

Example: 2019-06-01

timeslotstring · nullableOptional

Selected timeslot to visit. Required only for products that manage their availability using timeslots

passport_idstring · nullableOptional

Passport ID of the (main) visitor. Only if required for the product as advertised in Availability API. (On order level, not per individual visitor.)

zipcodeinteger · nullableOptional

The 5-digit US zipcode/postal code if the visitor lives in the United States. Only if required for the product as advertised in Availability API. (On order level, not per individual visitor.)

pickup_locationstring · nullableOptional

The holiday address of visitors. The tour provider may contact the visitor to arrange the nearest pickup location. Only if required for the product as advertised in Availability API. (On order level, not per individual visitor.)

dropoff_locationstring · nullableOptional

The address where the visitors want to be dropped off after the ordered product/activity. Only if required for the product as advertised in Availability API. (On order level, not per individual visitor.)

flight_numberstring · nullableOptional

The number of the flight the visitors arrive with. This allows the supplier to be at the right time and location if a product includes an airport pickup/dropoff. Only if required for the product as advertised in Availability API. (On order level, not per individual visitor.)

callback_urlstring · nullableOptional

Optional Callback URL (webhook) for order status change notifications. This URL will be called for all order status changes, including cancellation.

external_referencestring · nullableOptional

Partner's order reference ID. Maximum 255 characters, needs to be unique

Responses

200

Successful operation.

application/json

400

Bad Request -- Check your request parameters (typo in parameter or invalid value).

application/json

401

Unauthorized -- Your API key is incorrect.

application/json

403

Forbidden -- The endpoint or parameters are not allowed for the matching API key.

application/json

404

Not Found -- Requested resource/endpoint could not be found.

application/json

405

Method Not Allowed -- Check your request method.

application/json

429

Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.

application/json

500

Internal Server Error -- We had a problem with our server. Try again later.

application/json

503

Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

application/json

post

/orders

HTTPcURLJavaScriptPython

POST /v2/orders HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Content-Type: application/json
Accept: */*
Content-Length: 197

{
  "product_id": 1006356,
  "day": "2025-12-17",
  "variants": [
    {
      "variant_id": 38100,
      "count": 3
    }
  ],
  "customer_details": {
    "firstname": "Fred",
    "lastname": "Bloggs",
    "phone": "5551234",
    "email": "[email protected]"
  }
}

Order for a product with minimum requirementsOrder for a product with additional checkout fieldsOrder for a product with additional checkout fields and optional fields

{
  "success": true,
  "order_reference_id": "11111111",
  "payment_confirmation_token": "eyJhbGciOiJIUzI1NiJ9.eyJwYXltZW50X2lkIjo3ODkzMDh9.InZrWGpbEn09_S7jdjgntAtSt4DY_ZZ60rG5C_CkxzA",
  "estimated_commissions": [
    {
      "currency": "EUR",
      "variant_id": 32,
      "value": 1.36
    },
    {
      "currency": "EUR",
      "variant_id": 33,
      "value": 1.06
    }
  ],
  "price_components_eur": {
    "sale_ticket_value_incl_vat": 36.5,
    "booking_fee_incl_vat": 2,
    "sale_order_value_incl_vat": 38.5,
    "distributor_commission_excl_vat": 2.42
  },
  "price_components": {
    "sale_ticket_value_incl_vat": 38.2,
    "booking_fee_incl_vat": 2.25,
    "sale_order_value_incl_vat": 40.45,
    "distributor_commission_excl_vat": 2.68,
    "estimated_partner_rate": 37.77,
    "currency": "USD"
  }
}