---
title: "Get Recommended Carriers For Load From Carrier Pool"
method: POST
path: "/v2/tms/carrier-recommendation/get-recommended-carriers-for-load-from-carrier-pool"
tags: ["v2", "tms"]
---

# Get Recommended Carriers For Load From Carrier Pool

`POST /v2/tms/carrier-recommendation/get-recommended-carriers-for-load-from-carrier-pool`

## 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/carrier-recommendation/get-recommended-carriers-for-load-from-carrier-pool`
- Auth: HTTP bearer

Get recommended carriers for load from the Carrier Pool, scored in its own pass; a non-participant gets an empty list.

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- GetRecommendedCarriersForLoadRequest: Request body for getting carrier recommendations for a load.
  - `integration_connection_id` string, uuid, required
  - `load_id` string, uuid, nullable
  - `load_external_reference_id` string, nullable
  - `limit` integer

## Response `200`

Successful Response

- GetRecommendedCarriersForLoadResponse
  - `recommended_carriers` RecommendedCarrier[]
    - `carrier_id` string, uuid, nullable
    - `carrier_external_reference_id` string, required
    - `carrier_name` string, required
    - `carrier_dot_number` string, nullable
    - `carrier_mc_number` string, nullable
    - `carrier_defined_lanes` MentiumTmsCarrierDefinedLane[]
      - `id` string, uuid, nullable
      - `organization_id` string, uuid, required
      - `integration_connection_id` string, uuid, required
      - `carrier_id` string, uuid, nullable
      - `lane_hash` string, nullable
      - `source` union
        - 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
        - MentiumTmsArea: Represents a broad geographic area within a single country, defined by exactly one of: states, postal codes, or postal code prefixes. Use this when a carrier's lane/availability is described coarsely ("we run from Kansas City to TX, OK, FL, GA") rather than against a single point. - Exactly one of `states`, `postal_codes`, or `postal_code_prefixes` must be non-empty - All entries are normalized and de-duplicated; hash is deterministic
          - `kind` 'AREA'
          - `area_hash` string, nullable
          - `states` string[]
          - `postal_codes` string[]
          - `postal_code_prefixes` string[]
          - `country` string, required
      - `destination` union
        - 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
        - MentiumTmsArea: Represents a broad geographic area within a single country, defined by exactly one of: states, postal codes, or postal code prefixes. Use this when a carrier's lane/availability is described coarsely ("we run from Kansas City to TX, OK, FL, GA") rather than against a single point. - Exactly one of `states`, `postal_codes`, or `postal_code_prefixes` must be non-empty - All entries are normalized and de-duplicated; hash is deterministic
          - `kind` 'AREA'
          - `area_hash` string, nullable
          - `states` string[]
          - `postal_codes` string[]
          - `postal_code_prefixes` string[]
          - `country` string, required
      - `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'
      - `preference_level` 'PREFERRED' | 'PRIMARY' | 'SECONDARY' | 'BACKUP' | 'EXCLUDED', required
      - `target_line_haul_rate` number, nullable
      - `target_fuel_surcharge_rate` number, nullable
      - `notes` string, nullable
      - `automation_enabled` boolean
      - `is_contract` boolean
      - `contract_status` 'DRAFT' | 'ACTIVE' | 'PAUSED' | 'EXPIRED'
      - `contract_effective_at` string, date-time, nullable
      - `contract_expires_at` string, date-time, nullable
      - `contract_notes` string, nullable
      - `data_origins` MentiumTmsDataOrigin[]
    - `carrier_defined_availabilities` MentiumTmsCarrierDefinedAvailability[]
      - `id` string, uuid, nullable
      - `organization_id` string, uuid, required
      - `integration_connection_id` string, uuid, required
      - `carrier_id` string, uuid, nullable
      - `availability_hash` string, nullable
      - `source` union
        - 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
        - MentiumTmsArea: Represents a broad geographic area within a single country, defined by exactly one of: states, postal codes, or postal code prefixes. Use this when a carrier's lane/availability is described coarsely ("we run from Kansas City to TX, OK, FL, GA") rather than against a single point. - Exactly one of `states`, `postal_codes`, or `postal_code_prefixes` must be non-empty - All entries are normalized and de-duplicated; hash is deterministic
          - `kind` 'AREA'
          - `area_hash` string, nullable
          - `states` string[]
          - `postal_codes` string[]
          - `postal_code_prefixes` string[]
          - `country` string, required
      - `destination` union
        - 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
        - MentiumTmsArea: Represents a broad geographic area within a single country, defined by exactly one of: states, postal codes, or postal code prefixes. Use this when a carrier's lane/availability is described coarsely ("we run from Kansas City to TX, OK, FL, GA") rather than against a single point. - Exactly one of `states`, `postal_codes`, or `postal_code_prefixes` must be non-empty - All entries are normalized and de-duplicated; hash is deterministic
          - `kind` 'AREA'
          - `area_hash` string, nullable
          - `states` string[]
          - `postal_codes` string[]
          - `postal_code_prefixes` string[]
          - `country` string, required
      - `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'
      - `recurrence_frequency` 'ONCE' | 'DAILY' | 'WEEKLY_BY_DAY_OF_WEEK' | 'MONTHLY_BY_DAY_OF_MONTH' | 'MONTHLY_BY_DAY_OF_WEEK_MONTHLY_OCCURRENCE', required
      - `recurrence_interval` integer, nullable
      - `recurrence_start_at` string, date-time, required
      - `recurrence_end_at` string, date-time, nullable
      - `days_of_week` MentiumTmsAvailabilityDayOfWeek[]
      - `days_of_month` integer[]
      - `days_of_week_monthly_occurrences` MentiumTmsAvailabilityDayOfWeekMonthlyOccurrence[]
      - `notes` string, nullable
      - `data_origins` MentiumTmsDataOrigin[]
      - `created_by_kind` 'USER' | 'SYSTEM'
      - `created_by_user_id` string, uuid, nullable
      - `created_by_first_name` string, nullable
      - `created_by_last_name` string, nullable
      - `created_by_email` string, nullable
    - `potential_empty_truck_nearby_related_loads` LibsRecommendationsCarrierRecommendationModelsRelatedLoad[]
      - `load_external_reference_id` string, required
      - `first_pickup_stop_city` string, required
      - `first_pickup_stop_state` string, required
      - `first_pickup_stop_country` string, required
      - `last_delivery_stop_city` string, required
      - `last_delivery_stop_state` string, required
      - `last_delivery_stop_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
      - `last_delivery_stop_target_arrival_earliest_at` string, date-time, required
      - `last_delivery_stop_target_arrival_latest_at` string, date-time, required
      - `last_delivery_stop_estimated_earliest_at` string, date-time, nullable
      - `last_delivery_stop_estimated_latest_at` string, date-time, nullable
      - `tms_status` string, required
      - `mentium_status` 'PLANNED' | 'ACTIVE' | 'COVERED' | 'IN_TRANSIT' | 'DELIVERED' | 'COMPLETED' | 'TERMINATED' | 'ARCHIVED' | 'TEMP' | 'MENTIUM_UNKNOWN_VALUE', required
    - `carrier_match_score_explainability` CarrierMatchScoreExplainability, required
      - `carrier_unscoped_match_score` number, nullable
      - `carrier_customer_match_score` number, nullable
      - `carrier_lane_match_score` number, nullable
      - `carrier_customer_lane_match_score` number, nullable
      - `potential_empty_truck_nearby_match_score` number, nullable
      - `carrier_defined_lane_match_score` number, nullable
      - `carrier_defined_availability_match_score` number, nullable
      - `carrier_lane_propensity_match_score` number, nullable
    - `carrier_match_score` number, required
    - `data_origins` MentiumTmsDataOrigin[]
    - `from_carrier_pool` boolean
    - `send_email_offers_enabled` boolean
  - `overall_explainability` LibsRecommendationsCarrierRecommendationModelsOverallExplainability, required
    - `carrier_unscoped_match_score_importance` number, nullable
    - `carrier_customer_match_score_importance` number, nullable
    - `carrier_lane_match_score_importance` number, nullable
    - `carrier_customer_lane_match_score_importance` number, nullable
    - `potential_empty_truck_nearby_match_score_importance` number, nullable
    - `carrier_defined_lane_match_score_importance` number, nullable
    - `carrier_defined_availability_match_score_importance` number, nullable
    - `carrier_lane_propensity_match_score_importance` number, nullable
  - `warnings` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-04** `b4ed8e59432e`: 8 breaking, 48 info
  - the response property `recommended_carriers/items/carrier_defined_availabilities/items/equipment_type` became optional for the status `200`
  - the response property `recommended_carriers/items/carrier_defined_availabilities/items/shipping_method` became optional for the status `200`
  - the response property `recommended_carriers/items/carrier_defined_lanes/items/equipment_type` became optional for the status `200`
  - the response property `recommended_carriers/items/carrier_defined_lanes/items/shipping_method` became optional for the status `200`
  - …52 more

[Operation history](https://skmtc.dev/mentium/apis/mentium-api/changes/v2/tms/carrier-recommendation/get-recommended-carriers-for-load-from-carrier-pool/post.md)

---

[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)