---
title: "Search Carriers By Historical Lane"
method: POST
path: "/v2/tms/historical-lanes/search-carriers"
tags: ["v2", "tms", "historical_lanes"]
---

# Search Carriers By Historical Lane

`POST /v2/tms/historical-lanes/search-carriers`

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

Rank carriers by total loads run on a lane matching the given filters.

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- SearchCarriersByHistoricalLaneRequest
  - `integration_connection_id` string, required
  - `source` LocationFilterSchema: Location filter input for search-carriers-by-historical-lane requests.
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `postal_code_prefix` string, nullable
    - `country` string, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `radius_miles` number, nullable
  - `destination` LocationFilterSchema: Location filter input for search-carriers-by-historical-lane requests.
    - `city` string, nullable
    - `state` string, nullable
    - `postal_code` string, nullable
    - `postal_code_prefix` string, nullable
    - `country` string, nullable
    - `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'
  - `min_total_loads` integer, nullable
  - `limit` integer
  - `offset` integer
  - `sort_by` string
  - `sort_order` string

## Response `200`

Successful Response

- SearchCarriersByHistoricalLaneResponse
  - `carriers` HistoricalLaneCarrierSchema[]
    - `organization_id` string, required
    - `integration_connection_id` string, required
    - `carrier_id` string, required
    - `carrier_external_reference_id` string, required
    - `carrier_name` string, required
    - `carrier_dot_number` string, nullable
    - `carrier_mc_number` string, nullable
    - `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)