> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primefreight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Track your PrimeFreight ocean and air shipments.

The PrimeFreight Tracking API gives you programmatic access to your shipments across both ocean and air freight. It exposes three resources: **shipments**, **containers**, and container **events**. All responses are JSON. To begin, authenticate with a `POST` to obtain a token, then create a tracking request with a container number or bill of lading. Once tracking resolves, the shipment, container, and event data are available through read-only (`GET`) endpoints.

**Base URL**

```text theme={null}
https://api.primefreight.com/v2
```

All timestamps are ISO 8601 with a timezone offset.

<Note>
  The API returns the latest recorded state of each shipment and container. Fields that haven't been set yet come back as `null` rather than an error, so handle nulls on your side.
</Note>

## Resources

<CardGroup cols={2}>
  <Card title="Shipments" icon="ship" href="/api-reference/v2/get-shipment">
    The file-level record: references, status, schedule, parties, and the container it carries.
  </Card>

  <Card title="Containers" icon="box" href="/api-reference/v2/get-container">
    Equipment-level detail: current status and location, holds, last free day, and milestone dates.
  </Card>

  <Card title="Events" icon="timeline" href="/api-reference/v2/list-container-events">
    A container's status timeline, derived from its own change history.
  </Card>

  <Card title="Status values" icon="list-check" href="/api-reference/v2/status-values">
    The canonical journey ladder returned in `status`.
  </Card>
</CardGroup>