---
title: "List Historical Lanes"
method: GET
path: "/v2/tms/carriers/{carrier_id}/historical-lanes"
tags: ["v2", "tms", "historical_lanes"]
---

# List Historical Lanes

`GET /v2/tms/carriers/{carrier_id}/historical-lanes`

## 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/carriers/{carrier_id}/historical-lanes`
- Auth: HTTP bearer

List carrier historical lanes based on optional filters

## Path parameters

- `carrier_id` string, required

## Query parameters

- `integration_connection_id` string, required
- `source_city` string, nullable
- `source_state` string, nullable
- `source_country` string, nullable
- `source_postal_code` string, nullable
- `source_postal_code_prefix` string, nullable
- `source_latitude` number, nullable
- `source_longitude` number, nullable
- `source_radius_miles` number, nullable
- `destination_city` string, nullable
- `destination_state` string, nullable
- `destination_country` string, nullable
- `destination_postal_code` string, nullable
- `destination_postal_code_prefix` string, nullable
- `destination_latitude` number, nullable
- `destination_longitude` number, nullable
- `destination_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'
- `min_total_loads` integer, nullable
- `limit` integer
- `offset` integer
- `sort_by` 'total_loads'
- `sort_order` 'asc' | 'desc'

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- ListHistoricalLanesResponse
  - `historical_lanes` CarrierHistoricalLaneSchema[]
    - `organization_id` string, required
    - `integration_connection_id` string, required
    - `carrier_id` string, required
    - `source` HistoricalLaneLocationSchema, required: Location schema for historical lanes - city/state/country only
      - `city` string, nullable
      - `state` string, nullable
      - `country` string, nullable
    - `destination` HistoricalLaneLocationSchema, required: Location schema for historical lanes - city/state/country only
      - `city` string, nullable
      - `state` string, nullable
      - `country` string, nullable
    - `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
    - `total_loads` integer, required
  - `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)