Skip to main content
GET
/
orders
/
{reference}
Retrieve an order
curl --request GET \
  --url https://api.kalixo.io/v2/orders/{reference} \
  --header 'x-api-key: <api-key>'
{
  "orderId": 59400,
  "externalOrderCode": "O-12345",
  "status": "processing",
  "estimatedReadyAt": "2026-06-02T11:05:00Z",
  "message": "Order is still processing"
}

Authorizations

x-api-key
string
header
default:kal_live_xxxxxxxxxxxxxxxxxxxxxxxx
required

Your Kalixo API key. Send it in the x-api-key header on every request.

Path Parameters

reference
string
required

The numeric orderId or your externalOrderCode.

Example:

"O-12345"

Response

The order and its current status.

orderId
integer
Example:

59400

externalOrderCode
string
Example:

"O-12345"

status
enum<string>
Available options:
processing,
completed,
partially_completed,
failed
Example:

"completed"

estimatedReadyAt
string<date-time> | null
message
string | null
Example:

"Order is still processing"

reason
string | null
delivered
integer | null

Codes delivered so far (partial deliveries).

total
integer | null

Total codes in the order.

products
object[]

Present only when status is completed.

wallet
object