# Look up order status

Read only the order ID, numeric status, and most recent update time.

Company: Metfone Express
API version: v1
Requested language: en
Content language: en
Source: https://mfexpress-partner-docs.zhst.app/mfexpress/en/order-status

Endpoint: GET /order/{order_code}


```http
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.
```bash
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

```json
{
  "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](reference). HTTP success does not prove COD, fees, or cancellation are correct; inspect the documented business fields. Do not assume create-order retries are safe.