Get an order

Endpoint

GET /api/orders/{id}

Returns the details of a specific order owned by the authenticated member.

Path parameters

Parameter	Type	Required	Description
`id`	integer	Yes	The Transdirect order primary key (`id`), not the external `order_id`

Request

curl -X GET \
  -H "Api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://www.transdirect.com.au/api/orders/5001

Response

A successful response returns a 200 status code with the order object:

{
  "id": 5001,
  "transdirect_order_id": null,
  "transdirect_member_id": 12345,
  "transdirect_order_status": "pending",
  "order_id": "WC-1042",
  "goods_summary": "Widget Pro x2",
  "goods_dump": null,
  "imported_from": "Woocommerce",
  "imported_time": "2025-08-15T00:30:00+00:00",
  "purchased_time": "2025-08-15 10:00:00",
  "sale_price": "49.95",
  "selected_courier": null,
  "courier_price": "0",
  "paid_time": "2025-08-15 10:05:00",
  "buyer_name": "John Smith",
  "buyer_email": "john@example.com.au",
  "delivery": {
    "name": "John Smith",
    "email": "john@example.com.au",
    "phone": "0498765432",
    "address": "42 George Street"
  },
  "last_updated": "2025-08-15T00:30:00+00:00"
}

Response fields

Field	Type	Description
`id`	integer	Unique Transdirect order id
`order_id`	string	External order number from the source system
`transdirect_order_id`	integer \| null	Linked booking id when converted
`transdirect_order_status`	string	Order status — see statuses
`imported_from`	string	Integration source
`imported_time`	string	ISO 8601 import time
`delivery`	object	Nested delivery contact (`name`, `email`, `phone`, `address`)
`buyer_name` / `buyer_email`	string	Buyer details
`goods_summary` / `goods_dump`	string	Goods summary / raw dump
`sale_price` / `courier_price`	string \| number	Commercial values
`selected_courier`	string \| null	Courier string_id when set
`last_updated`	string	Last update timestamp

Order statuses

Status	Description
`pending`	Order imported but not yet ready to book.
`ready_to_book`	Order has the details needed for a booking.
`booked`	Order has been converted to a confirmed booking.
`manually_dispatched`	Order was fulfilled outside the Transdirect booking flow.
`cancelled`	Order has been cancelled.
`deleted`	Order has been marked deleted (not returned by list).
`removed`	Order has been removed from the active list.

Error responses

Status code	Meaning
`401`	Unauthorised — invalid credentials or API key
`403`	Order does not exist or does not belong to your account