Search Carriers With Trucks

Changed on Nov 4, 2026

Search for carriers with trucks

post/v2/tms/trucks/search-carriers-with-trucks

Request

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

Headers

mentium-workspace-idstring nullable

Request body

integration_connection_idstring uuid required

shipping_method'FTL' | 'PTL' | 'LTL' | 'MENTIUM_UNKNOWN_VALUE'

first_pickup_stop_target_arrival_earliest_atstring date-time nullable

first_pickup_stop_target_arrival_latest_atstring date-time nullable

limitinteger

offsetinteger

Example request

{
  "source": {
    "description": "City with state, country, coordinates and radius",
    "value": {
      "city": "Chicago",
      "country": "US",
      "latitude": 41.8781,
      "longitude": -87.6298,
      "radius_miles": 50,
      "state": "IL"
    }
  },
  "destination": {
    "description": "City with state, country, coordinates and radius",
    "value": {
      "city": "Chicago",
      "country": "US",
      "latitude": 41.8781,
      "longitude": -87.6298,
      "radius_miles": 50,
      "state": "IL"
    }
  }
}

Response

Successful Response

total_countinteger required

has_moreboolean required

Example response

{
  "carriers_with_trucks": [
    {
      "carrier_defined_availabilities": [
        {
          "description": "ONCE - Single specific date availability",
          "value": {
            "carrier_id": "carrier-789",
            "data_origins": [
              "MENTIUM"
            ],
            "days_of_month": [],
            "days_of_week": [],
            "days_of_week_monthly_occurrences": [],
            "destination": {
              "city": "Atlanta",
              "country": "US",
              "latitude": 33.749,
              "longitude": -84.388,
              "postal_code": "30303",
              "postal_code_prefix": "303",
              "radius_miles": 75,
              "state": "GA"
            },
            "equipment_type": "DRY_VAN",
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "integration_connection_id": "int-456",
            "notes": "One-time backhaul opportunity after conference",
            "organization_id": "org-123",
            "recurrence_end_at": "2026-01-15T00:00:00Z",
            "recurrence_frequency": "ONCE",
            "recurrence_start_at": "2026-01-15T00:00:00Z",
            "shipping_method": "FTL",
            "source": {
              "city": "Dallas",
              "country": "US",
              "latitude": 32.7767,
              "longitude": -96.797,
              "postal_code": "75201",
              "postal_code_prefix": "752",
              "radius_miles": 100,
              "state": "TX"
            }
          }
        }
      ]
    }
  ]
}

Changes

Nov 4, 2026b4ed8e59432e Revision changes
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the //// response's property type changed from string to no type for status
- breaking
  the //// response's property type changed from string to no type for status
- info
  added subschema #2 to the //// response property anyOf list for the response status
- info
  added subschema #2 to the //// response property anyOf list for the response status
- info
  removed the BULK_DRY_DUMP enum value from the //// response property for the response status
- info
  removed the BULK_DRY_HOPPER enum value from the //// response property for the response status
- info
  removed the BULK_DRY_PNEUMATIC enum value from the //// response property for the response status
- info
  removed the DRY_VAN enum value from the //// response property for the response status
- info
  removed the FLATBED enum value from the //// response property for the response status
- info
  removed the FLATBED_CONESTOGA enum value from the //// response property for the response status
- info
  removed the FTL enum value from the //// response property for the response status
- info
  removed the HOTSHOT enum value from the //// response property for the response status
- info
  removed the INTERMODAL enum value from the //// response property for the response status
- info
  removed the LOWBOY enum value from the //// response property for the response status
- info
  removed the LTL enum value from the //// response property for the response status
- info
  removed the MENTIUM_UNKNOWN_VALUE enum value from the //// response property for the response status
- info
  removed the MENTIUM_UNKNOWN_VALUE enum value from the //// response property for the response status
- info
  removed the POWER_ONLY enum value from the //// response property for the response status
- info
  removed the PTL enum value from the //// response property for the response status
- info
  removed the REEFER enum value from the //// response property for the response status
- info
  removed the REMOVABLE_GOOSENECK enum value from the //// response property for the response status
- info
  removed the SPRINTER enum value from the //// response property for the response status
- info
  removed the STEPDECK enum value from the //// response property for the response status
- info
  removed the STEPDECK_CONESTOGA enum value from the //// response property for the response status
- info
  removed the STRAIGHT enum value from the //// response property for the response status
- info
  removed the TANKER enum value from the //// response property for the response status

Operation history