Get order status

GET

api

flights

orders

{orderId}

curl "https://api.staging.ttool.travel/hub/api/v1/flights/orders/184233" \
  -H "Authorization: Bearer $TOKEN"

{
  "orderId": 184233,
  "orderCode": 1005123,
  "status": "OnHold",
  "pnr": "ABC123",
  "price": { "currency": "USD", "total": 350.90 },
  "hold": { "expiresAt": "2026-11-21T14:30:00", "isFinal": true, "serverTime": "2026-11-20T10:12:40" },
  "flights": [ { "...": "as in the issue response" } ],
  "tickets": []
}

{
  "success": false,
  "error": { "errorCode": "ORDER_NOT_FOUND", "errorCategory": "NotFound", "httpStatusCode": 404 }
}

Use it to show a hold countdown, to pick up the outcome after an issue timeout, and to confirm the state before releasing a hold. Create order returns this same object.

Path

integer

required

The orderId returned by create order.

Response

integer

Human-readable order number.

string

Submit (created, nothing booked), OnHold, HoldExpired, HoldCancelled, Reserved, PaymentSucceeded, IssueInProgress, IssuedSucceeded, IssueFailed, OfflineIssueRequired, and the rest of the issue status vocabulary.

string

Airline record locator.

object

currency and total.

object

Present only for an order booked with holdOnly.

Show properties

string | null

Latest moment the order can still be issued. null until the airline has reported it.

boolean

false while the airline may still revise the deadline.

string

Platform clock, the same clock as expiresAt.

object[]

As in the issue response.

object[]

Empty until the order is issued.

Errors

HTTP	`errorCode`	Action
404	`ORDER_NOT_FOUND`	Unknown order, or not your agency’s

curl "https://api.staging.ttool.travel/hub/api/v1/flights/orders/184233" \
  -H "Authorization: Bearer $TOKEN"

{
  "orderId": 184233,
  "orderCode": 1005123,
  "status": "OnHold",
  "pnr": "ABC123",
  "price": { "currency": "USD", "total": 350.90 },
  "hold": { "expiresAt": "2026-11-21T14:30:00", "isFinal": true, "serverTime": "2026-11-20T10:12:40" },
  "flights": [ { "...": "as in the issue response" } ],
  "tickets": []
}

{
  "success": false,
  "error": { "errorCode": "ORDER_NOT_FOUND", "errorCategory": "NotFound", "httpStatusCode": 404 }
}

curl "https://api.staging.ttool.travel/hub/api/v1/flights/orders/184233" \
  -H "Authorization: Bearer $TOKEN"

{
  "orderId": 184233,
  "orderCode": 1005123,
  "status": "OnHold",
  "pnr": "ABC123",
  "price": { "currency": "USD", "total": 350.90 },
  "hold": { "expiresAt": "2026-11-21T14:30:00", "isFinal": true, "serverTime": "2026-11-20T10:12:40" },
  "flights": [ { "...": "as in the issue response" } ],
  "tickets": []
}

{
  "success": false,
  "error": { "errorCode": "ORDER_NOT_FOUND", "errorCategory": "NotFound", "httpStatusCode": 404 }
}

Get started

Guides

Reference

API endpoints

Path

Response

Errors

​Path

​Response

​Errors

Path

Response

Errors