---
title: "Portfolio summary — counts, exceptions, arriving soon"
method: GET
path: "/v1/containers/summary"
---

# Portfolio summary — counts, exceptions, arriving soon

`GET /v1/containers/summary`

## Request

- Base URL: `https://api.trackingmcp.com`
- URL: `https://api.trackingmcp.com/v1/containers/summary`
- Auth: HTTP bearer

## Query parameters

- `filter` 'all' | 'exceptions' | 'arriving_soon' | 'demurrage_risk'

## Response `200`

Aggregated fleet summary.

- object
  - `ok` true, required
  - `api_version` string: The response contract this build answers, as a date. Pin it in your client.
  - `data` PortfolioSummary, required: The payload. Everything an endpoint returns sits under this key.
    - `total_active` integer: Containers you are tracking, excluding archived ones.
    - `exceptions` integer: Count of shipments in an exception state: customs hold, rolled, delayed or at transshipment.
    - `arriving_this_week` integer: Count with an ETA in the next seven days.
    - `demurrage_risk_usd` integer: Demurrage already accrued across the book, in USD.
    - `containers` object[]: Tracked containers on the account.
      - `id` string, nullable: Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.
      - `status` string: Current normalised status of the shipment. Ocean lifecycle order: discharged, available, delivered, returned_empty. Two values end a shipment, delivered and returned_empty, and returned_empty outranks delivered.
      - `eta` string, nullable: Arrival time (ISO 8601). Null when the carrier publishes none and we cannot predict one.
      - `vessel_name` string, nullable: Name of the carrying vessel, or null when the carrier named none.
      - `vessel_imo` string, nullable: IMO number of the carrying vessel, or null when unknown.

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/trackingmcp/apis/trackingmcp-rest-api.md) · [All operations](https://skmtc.dev/trackingmcp/apis/trackingmcp-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trackingmcp/apis/trackingmcp-rest-api/revisions/6bb8d8172ceb?raw)