Skip to main content
GET
/
orders
/
track
/
{orderId}
Track order delivery status
curl --request GET \
  --url https://www.postable.com/api/v1/orders/track/{orderId} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "project_uuid": "<string>",
      "recipients": [
        {
          "internal_id": "<string>",
          "status": "<string>",
          "name": "<string>",
          "address": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>",
          "country": "<string>",
          "scheduled_delivery_date": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        }
      ]
    }
  ]
}

​
Overview

Retrieve tracking information for all recipients in an order. This includes delivery status, addresses, and expected delivery dates.

​
Tracking Data

For each project in the order, you’ll receive tracking information for all recipients including:
  • internal_id: Your internal identifier (if provided when adding recipients)
  • status: Current delivery status
  • scheduled_delivery_date: Expected delivery date (when available)

​
Example Response

{
  "data": [
    {
      "project_uuid": "123e4567-e89b-12d3-a456-426614174000",
      "recipients": [
        {
          "internal_id": "CUST-001",
          "status": "In Transit",
          "name": "John Doe",
          "address": "123 Main St",
          "city": "Anytown",
          "state": "CA",
          "zip": "12345",
          "country": "United States",
          "scheduled_delivery_date": "2026-01-28T00:00:00+00:00",
          "updated_at": "2026-01-23T15:30:00+00:00"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
orderId
integer
required

ID of the order to track

Response

Order tracking information

​
data
object[]