GET /tms-partner/api/v1/order/{order_code}Usage and important notes
Exactly three fields: id, numeric status, and updated_at. This endpoint does not return the create-order response, pricing, full addresses, or parcel details. Preserve the create response for full order data; webhook messages provide journey updates, not a replacement full-order snapshot.
Compare numeric status with the webhook status table. Do not confuse it with create-order’s textual CONFIRMED. updated_at records the latest status change.
Authentication headers
| Header | Requirement | Value / meaning |
|---|---|---|
| X-Api-Token | Required | ${API_TOKEN}: environment-specific token issued by TMS |
| X-Client-Source | Required | ${PARTNER_CODE}: partner code paired with the token |
| Content-Type | With a JSON body | application/json |
| Accept | Required by source | application/json |
| Accept-Language | Optional | vn, en, my, km, lo |
Path and query parameters
| Name | Location | Required | Description |
|---|---|---|---|
| order_code | path | Yes | The id returned by create-order. |
cURL example
BASE_URL must include /tms-partner/api/v1. Load the token and partner code from your private environment; never paste secrets into documentation or AI prompts.
curl --request GET "${BASE_URL}/order/${ORDER_CODE}" \
--header "X-Api-Token: ${API_TOKEN}" \
--header "X-Client-Source: ${PARTNER_CODE}" \
--header "Accept-Language: en" \
--header "Accept: application/json"Example response
{
"id": "EXAMPLE-ORDER-001",
"status": 110,
"updated_at": "2026-10-14T09:00:00.000+00:00"
}Response fields
| Field | Type | Required | Description |
|---|---|---|---|
id |
string | See description | Use the identifier returned by the API, not the illustrative value. |
status |
integer | See description | Current numeric status; use the webhook status table. |
updated_at |
string | See description | Last status update time. |
Error handling
See HTTP codes and source limitations. HTTP success does not prove COD, fees, or cancellation are correct; inspect the documented business fields. Do not assume create-order retries are safe.