Get order information

The endpoint to retrieve the order information, including order cancellations.

Get order information

get

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

/orders/{orderReferenceId}

Path parameters

orderReferenceIdstringRequired

Unique ID of order.

Example: 1111111

Query parameters

langstringOptional

Language of the content to retrieve (ISO 639-1). Defaults to English if undefined.

Example: en

externalbooleanOptional

Set this parameter to true to trace an order using the partner's own order ID (defined as external_reference upon order creation) as orderReferenceId.

Example: true

Header parameters

AuthorizationstringRequired

Token <Your_API_Key>.

Default: Token <Partner_API_key>.

Responses

200

Successful operation.

application/json

product_idintegerOptional

ID of the booked product.

promoted_product_idinteger · nullableOptional

Only applicable for products that aggregate the availability of a group of products. The promoted_product_id is the ID that was originally promoted while the actually booked product is different.

order_reference_idstringOptional

Order reference ID of the order.

basket_reference_idstringOptional

Basket reference ID of the order.

daystring · nullableOptional

Booked visit date.

timeslotstring · nullableOptional

Booked timeslot at the given visit date.

order_statusstringOptional

The order status, as one of the following values:

• new: Order was created, but not yet confirmed or paid.
• pending: Order was confirmed or paid, and the tickets are still being processed.
• failed: Order was not paid or the ticket processing failed.
• done: Order was completed and PDF tickets have been generated.
• cancelled: Order was cancelled after it had been completed.

is_currently_cancellablebooleanOptional

Indicates if the order is currently eligible for cancellation.

cancellation_deadlinestring · nullableOptional

The latest timestamp allowed for the order cancellation. Only returned if the value of is_currently_cancellable is true. Format ISO_8601 YYYY-MM-DDTHH:MM:SS±HH:MM.

external_referencestring · nullableOptional

External order ID as provided upon order creation API request. Unique, maximum 255 characters

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

get

/orders/{orderReferenceId}

HTTPcURLJavaScriptPython

GET /v2/orders/{orderReferenceId} HTTP/1.1
Host: api.tiqets.com
Authorization: Token <Partner_API_key>.
Accept: */*

{
  "success": true,
  "order_reference_id": "91782315",
  "basket_reference_id": "4756756758",
  "product_id": 918256,
  "promoted_product_id": 123456,
  "day": "2025-06-20",
  "timeslot": "09:00",
  "order_status": "done",
  "variants": [
    {
      "count": 1,
      "variant_id": 24
    }
  ],
  "customer_details": {
    "email": "[email protected]",
    "firstname": "Bart",
    "lastname": "Simpson",
    "phone": "+1234"
  },
  "is_currently_cancellable": true,
  "cancellation_deadline": "2025-06-18T10:00:00+01:00",
  "price_components_eur": {
    "sale_ticket_value_incl_vat": 14.5,
    "booking_fee_incl_vat": 0,
    "sale_order_value_incl_vat": 14.5,
    "distributor_commission_excl_vat": 0
  },
  "price_components": {
    "sale_ticket_value_incl_vat": 15.05,
    "booking_fee_incl_vat": 0,
    "sale_order_value_incl_vat": 15.05,
    "distributor_commission_excl_vat": 1,
    "estimated_partner_rate": 14.05,
    "currency": "USD"
  }
}