# List tracking events

`GET /client_api/v2/orders/{order_id}/tracking`

What the carrier has reported about the shipment, newest first.

## Parameters

- `order_id` (integer, required): The order's id. Get it from List orders (`GET /client_api/v2/orders`): send the `id` of the one you want. Ids differ between the sandbox and production.

## Returns

Returns the result.

- `shipment_events` (array of objects, required): The tracking events on this page, newest first.
  - `id` (integer, required): The event's id.
  - `date_time` (string, required): When it happened, as `YYYY/MM/DD HH:MM:SS UTC`.
  - `description` (string, required): What happened, in the carrier's words.
  - `latitude` (object, nullable, required): Where it happened, when the carrier says. Usually empty.
  - `location` (string, required): Where it happened, as the carrier reports it.
  - `longitude` (object, nullable, required): Where it happened, when the carrier says. Usually empty.
  - `order_id` (integer, required): The order the event belongs to.
- `meta` (object, required): How many pages and records the list has.
  - `page_count` (integer, required): How many pages the list has. Ask for another with `?page=`.
  - `record_count` (integer, required): How many records the list has across all pages.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/orders/3/tracking" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
{
  "shipment_events": [
    {
      "id": 3,
      "date_time": "2026/10/28 09:12:00 UTC",
      "description": "Arrived at FedEx hub",
      "latitude": null,
      "location": "STANSTED, GB",
      "longitude": null,
      "order_id": 3
    },
    {
      "id": 2,
      "date_time": "2026/10/27 03:40:00 UTC",
      "description": "Departed FedEx hub",
      "latitude": null,
      "location": "JOHANNESBURG, ZA",
      "longitude": null,
      "order_id": 3
    },
    {
      "id": 1,
      "date_time": "2026/10/26 14:05:00 UTC",
      "description": "Picked up",
      "latitude": null,
      "location": "CAPE TOWN, ZA",
      "longitude": null,
      "order_id": 3
    }
  ],
  "meta": {
    "page_count": 1,
    "record_count": 3
  }
}
```