Skip to main content
GET
/
tracking
/
{id}
Get shipment tracking
curl --request GET \
  --url https://api.flexforward.com/tracking/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "trackingNumber": "YT2503010001CN",
  "tag": "InTransit",
  "subtag": "InTransit_001",
  "subtagMessage": "In transit",
  "slug": "yunexpress",
  "checkpoints": [
    {
      "checkpointTime": "2025-03-02T10:30:00.000Z",
      "city": "Shenzhen",
      "state": "Guangdong",
      "countryRegion": "CN",
      "location": null,
      "message": "Shipment departed from sorting center",
      "tag": "InTransit",
      "subtag": "InTransit_001",
      "subtagMessage": "In transit",
      "slug": "yunexpress"
    },
    {
      "checkpointTime": "2025-03-01T14:00:00.000Z",
      "city": "Shenzhen",
      "state": "Guangdong",
      "countryRegion": "CN",
      "location": null,
      "message": "Shipment received at origin facility",
      "tag": "InTransit",
      "subtag": "InTransit_001",
      "subtagMessage": "In transit",
      "slug": "yunexpress"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API access token issued by the Flex Forward team during onboarding.

Path Parameters

​
id
string<uuid>
required

Label ID returned by the create-label endpoint.

Response

Tracking information retrieved successfully.

​
id
string<uuid>
required

Label identifier.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

​
trackingNumber
string | null
required

Courier-assigned tracking number, or null if not yet available.

Example:

"YT2503010001CN"

​
tag
string
required

High-level tracking status. Possible values: Pending, InfoReceived, InTransit, Delivered, Exception, Cancelled, Unknown.

Example:

"InTransit"

​
subtag
string
required

Detailed status sub-tag.

Example:

"InTransit_001"

​
subtagMessage
string
required

Human-readable description of the sub-tag.

Example:

"In transit"

​
slug
string
required

Courier service slug.

Example:

"yunexpress"

​
checkpoints
object[]
required