# Get Billing & Void Status

Retrieve the carrier billing state and void state of a previously purchased label, looked up by tracking number.

Endpoint: GET /api/shipments/status
Version: v1
Security: BearerAuth, ApiTokenAuth

## Query parameters:

  - `tracking_code` (string, required)
    Tracking number of the shipment to look up.

## Response 200 fields (application/json):

  - `tracking_code` (string)
    Tracking number of the matched shipment, echoed from the stored shipment record.
    Example: 1ZXXXXXXXXXXXX

  - `bill_status` (string)
    Carrier billing state.
- `pending` — not yet reconciled; the state of a newly purchased label
- `ready` — queued for reconciliation
- `completed` — reconciled; `bill_rate` is final
    Example: completed

  - `bill_rate` (number)
    Amount actually billed by the carrier, in USD, always to two decimal places.
    Example: 22.68

  - `void_status` (string)
    Void state of the label.

  - `adjust_time` (string)
    Timestamp of the most recent billing adjustment on this shipment, as an ISO-8601 UTC instant with second precision. `null` when the shipment has never been adjusted.
    Example: 2026-07-29T07:00:05Z

## Response 400 fields (application/json):

  - `message` (string)
    Human-readable error message.
    Example: Invalid request parameters.