Tracking

Get the same tracking information you see in your panel. Fetch it to show customers in your app or to update your order management system.

Tracking Numbers

Every order is assigned a unique tracking number when created. The tracking number format is:

4NXXXXXXXXXXXX

Where XXXXXXXXXXXX is a 12-digit unique identifier (e.g., 4N000000012345). Tracking numbers always start with 4N or SH.

Timeline events

You get the same timeline you see when clicking an order in your panel. Each event shows:

Field	Type	Description
`state`	string	The delivery state at this point
`timestamp`	datetime	When the event occurred
`type`	string	Event type (e.g., `state_change`)
`failure_info`	object\|null	Details about failure (if applicable)

Example Timeline

{
  "timeline": [
    {
      "state": "pending",
      "timestamp": "2025-02-03T10:00:00.000000Z",
      "type": "state_change",
      "failure_info": null
    },
    {
      "state": "picked_up",
      "timestamp": "2025-02-03T14:30:00.000000Z",
      "type": "state_change",
      "failure_info": null
    },
    {
      "state": "in_transit",
      "timestamp": "2025-02-03T18:00:00.000000Z",
      "type": "state_change",
      "failure_info": null
    },
    {
      "state": "out_for_delivery",
      "timestamp": "2025-02-04T08:00:00.000000Z",
      "type": "state_change",
      "failure_info": null
    },
    {
      "state": "delivered",
      "timestamp": "2025-02-04T11:30:00.000000Z",
      "type": "state_change",
      "failure_info": null
    }
  ]
}

Proof of delivery

Once an order is delivered, you can fetch the same proof you see in your panel - who received it, where, and photos.

What's included

Field	Type	Description
`recipient_name`	string	Name of person who received the package
`recipient_rut`	string	Chilean ID number (optional)
`recipient_role`	string	Role of the person who received (e.g., `recipient`)
`notes`	string\|null	Additional delivery notes
`location`	object	GPS coordinates of delivery
`photos`	array	Delivery photos
`delivered_at`	datetime	Exact delivery timestamp

Location Object

{
  "location": {
    "latitude": -33.4489,
    "longitude": -70.6693
  }
}

Photos Array

{
  "photos": [
    {
      "url": "https://storage.example.com/photos/full/abc123.jpg",
      "preview_url": "https://storage.example.com/photos/thumb/abc123.jpg"
    }
  ]
}

Delivery photos are kept for 90 days. Download any you need for your records before then.

Get updates automatically

Instead of checking your panel or calling the API repeatedly, set up webhooks to get notified when orders move.

When to use what

Approach	Best for
Webhooks	Updating your system automatically when status changes
Tracking API	Showing customers their order status on demand

See the Webhooks documentation for setup.