---
title: "List Late Loads"
method: GET
path: "/v2/tms/late-loads/"
tags: ["v2", "tms", "late-loads"]
---

# List Late Loads

`GET /v2/tms/late-loads/`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms/late-loads/`
- Auth: HTTP bearer

List late-load tracking episodes for the current workspace.

Episodes from org-level connections (NULL workspace_id) are shared across
every workspace in the org, so they match alongside the current workspace.

## Query parameters

- `status` string[], nullable: Status filter; defaults to active (LATE) episodes
- `integration_connection_id` string, nullable
- `include_acknowledged` boolean
- `limit` integer
- `offset` integer
- `sort_by` string
- `sort_order` string

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- LateLoadEpisodeListResponse: Paged list of late-load episodes.
  - `items` LateLoadEpisodeSchema[], required
    - `id` string, required
    - `organization_id` string, required
    - `workspace_id` string, nullable
    - `integration_connection_id` string, required
    - `load_external_reference_id` string, required: Load reference in the source TMS
    - `vortex_load_id` string, nullable
    - `stop_key` string, required
    - `stop_number` integer, nullable
    - `stop_type` string, nullable
    - `contact_name` string, nullable
    - `contact_phone` string, nullable
    - `contact_source` string, nullable: Where the contact came from: load.driver_carrier_contact or load.dispatcher_carrier_contact
    - `status` 'LATE' | 'RESOLVED_ON_TIME' | 'RESOLVED_LATE' | 'CLOSED', required: Episode lifecycle status
    - `appointment_start_at` string, date-time, required
    - `appointment_end_at` string, date-time, nullable
    - `deadline_at` string, date-time, required
    - `deadline_source` 'appointment' | 'target_arrival': Which timestamp the deadline came from: 'appointment' (committed dock slot) or 'target_arrival' (looser routing latest-arrival bound, used when the TMS supplies no appointment). When 'target_arrival', appointment_start_at/deadline_at carry the target arrival time, not a booked appointment.
    - `predicted_arrival_at` string, date-time, nullable
    - `actual_arrival_at` string, date-time, nullable
    - `minutes_late` integer, nullable
    - `reason` string, nullable
    - `tms_status` string, nullable: Raw TMS load status (live when resolvable, else at detection time)
    - `mentium_status` string, nullable: Mentium load status (live when resolvable, else at detection time)
    - `tracking_link_url` string, nullable
    - `customer_name` string, nullable: Load customer name (live from Vortex)
    - `origin` string, nullable: First pickup location, e.g. 'Dallas, TX'
    - `destination` string, nullable: Last delivery location, e.g. 'Atlanta, GA'
    - `assigned_rep` string, nullable: Assigned rep display value (email or name; TMS user id only as a last resort)
    - `workflow_execution_id` string, nullable: Nexus workflow execution started by this episode's trigger
    - `first_detected_at` string, date-time, required
    - `last_detected_at` string, date-time, required
    - `triggered_at` string, date-time, nullable
    - `resolved_at` string, date-time, nullable
    - `acknowledged_at` string, date-time, nullable
    - `acknowledged_by` string, nullable
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)
