---
title: "Returns a shipment with status info"
method: GET
path: "/shipments/status"
tags: ["Shipper"]
---

# Returns a shipment with status info

`GET /shipments/status`

## Query parameters

- `shipmentReference` string, required

## Response `200`

Status Code 200:  Successful Response - the request was successful!

- ShipmentResponse
  - `success` boolean
  - `shipments` object[]
    - `shipmentId` string
    - `shipmentReference` string
    - `status` string
    - `stops` object[]
      - `stopId` string
      - `locationName` string
      - `locationAddress` string
      - `windowStart` string, date-time
      - `windowEnd` string, date-time
      - `appointmentConfirmed` boolean
      - `complete` boolean
      - `off_site` boolean
      - `sequence` integer
    - `carrierId` string
    - `driver` object
      - `_id` string
      - `_type` string
      - `first_name` string
      - `last_name` string
    - `distance_in_miles` string, nullable

## Other responses

- `400` — Status Code 400: Bad Request Response - the request header and/or body is invalid
- `500` — StatusCode 500: Internal Server Error Response - there's a problem with the Public API service

---

[API](https://skmtc.net/cargomatic/apis/cargomatic-public-api.md) · [All operations](https://skmtc.net/cargomatic/apis/cargomatic-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cargomatic/cargomatic-public-api/revisions/4aa7f4326443/schema)