---
title: "Get Loads For Truck"
method: POST
path: "/v2/tms/trucks/get-loads-for-truck"
tags: ["v2", "tms", "trucks"]
---

# Get Loads For Truck

`POST /v2/tms/trucks/get-loads-for-truck`

## 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/trucks/get-loads-for-truck`
- Auth: HTTP bearer

Get loads for truck

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- GetLoadsForTruckRequest
  - `integration_connection_id` string, uuid, required
  - `carrier_id` string, uuid, nullable
  - `carrier_external_reference_id` string, nullable
  - `availability_id` string, uuid, nullable
  - `source` MentiumTmsLocation: Represents a single geographic point within a country, defined by exactly one of five valid combinations: city/state/country/lat/lon/radius, state/country, postal-code/country, postal-code-prefix/country, or lat/lon/radius/country. Use this when a carrier's lane/availability is described precisely ("from Chicago, IL to Austin, TX") rather than across a broad multi-state area. - Exactly one of the five field combinations must be satisfied - All fields are normalized and validated; hash is deterministic
    - `kind` 'LOCATION'
    - `location_hash` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `postal_code_prefix` string, nullable
    - `country` string, required
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `radius_miles` number, nullable
  - `destination` MentiumTmsLocation: Represents a single geographic point within a country, defined by exactly one of five valid combinations: city/state/country/lat/lon/radius, state/country, postal-code/country, postal-code-prefix/country, or lat/lon/radius/country. Use this when a carrier's lane/availability is described precisely ("from Chicago, IL to Austin, TX") rather than across a broad multi-state area. - Exactly one of the five field combinations must be satisfied - All fields are normalized and validated; hash is deterministic
    - `kind` 'LOCATION'
    - `location_hash` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `postal_code_prefix` string, nullable
    - `country` string, required
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `radius_miles` number, nullable
  - `shipping_method` 'FTL' | 'PTL' | 'LTL' | 'MENTIUM_UNKNOWN_VALUE'
  - `equipment_type` 'DRY_VAN' | 'REEFER' | 'FLATBED' | 'FLATBED_CONESTOGA' | 'STEPDECK' | 'STEPDECK_CONESTOGA' | 'LOWBOY' | 'REMOVABLE_GOOSENECK' | 'BULK_DRY_HOPPER' | 'BULK_DRY_PNEUMATIC' | 'BULK_DRY_DUMP' | 'TANKER' | 'INTERMODAL' | 'STRAIGHT' | 'SPRINTER' | 'HOTSHOT' | 'POWER_ONLY' | 'MENTIUM_UNKNOWN_VALUE'
  - `first_pickup_stop_target_arrival_earliest_at` string, date-time, nullable
  - `first_pickup_stop_target_arrival_latest_at` string, date-time, nullable
  - `limit` integer

## Response `200`

Successful Response

- GetLoadsForTruckResponse
  - `loads_for_truck` LoadForTruck[]
    - `customer_id` string, uuid, nullable
    - `customer_name` string, required
    - `load_id` string, uuid, nullable
    - `load_external_reference_id` string, required
    - `source_city` string, required
    - `source_state` string, required
    - `source_country` string, required
    - `destination_city` string, required
    - `destination_state` string, required
    - `destination_country` string, required
    - `shipping_method` 'FTL' | 'PTL' | 'LTL' | 'MENTIUM_UNKNOWN_VALUE', required
    - `equipment_type` 'DRY_VAN' | 'REEFER' | 'FLATBED' | 'FLATBED_CONESTOGA' | 'STEPDECK' | 'STEPDECK_CONESTOGA' | 'LOWBOY' | 'REMOVABLE_GOOSENECK' | 'BULK_DRY_HOPPER' | 'BULK_DRY_PNEUMATIC' | 'BULK_DRY_DUMP' | 'TANKER' | 'INTERMODAL' | 'STRAIGHT' | 'SPRINTER' | 'HOTSHOT' | 'POWER_ONLY' | 'MENTIUM_UNKNOWN_VALUE', required
    - `first_pickup_stop_target_arrival_earliest_at` string, date-time, required
    - `first_pickup_stop_target_arrival_latest_at` string, date-time, required
    - `tms_status` string, required
    - `mentium_status` 'PLANNED' | 'ACTIVE' | 'COVERED' | 'IN_TRANSIT' | 'DELIVERED' | 'COMPLETED' | 'TERMINATED' | 'ARCHIVED' | 'TEMP' | 'MENTIUM_UNKNOWN_VALUE', required
    - `distance_miles` number, required
    - `pickup_deadhead_distance_miles` number, nullable
    - `data_origins` MentiumTmsDataOrigin[]
  - `total_count` integer, required
  - `has_more` boolean, 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)