List Carriers

GET /v2/tms-api/carriers

Retrieve a paginated list of carriers in your organization.

API Reference

Query Parameters

pageintegerdefault: 1

Page number (1-indexed)

page_sizeintegerdefault: 50

Number of items per page (max 100)

name_containsstring

Filter by name (contains search)

mc_numberstring

Filter by MC number (deprecated — use DOT)

dot_numberstring

Filter by DOT number

sortstring

Sort field and direction. Format: `field` (ascending) or `-field` (descending)

Request Examples

cURL

curl -X GET "https://api.mentium.io/v2/tms-api/carriers?page=1&page_size=50" \
  -H "X-API-Key: your_api_key_here"

Python

import requests

response = requests.get(
    "https://api.mentium.io/v2/tms-api/carriers",
    headers={"X-API-Key": "your_api_key_here"},
    params={"page": 1, "page_size": 50}
)
print(response.json())

Response

200 OK

{
  "items": [
    {
      "id": "carrier_abc123",
      "external_reference_id": "CARRIER-MIDWEST-001",
      "name": "Midwest Express Trucking",
      "dot_number": "DOT789012",
      "phone_number": "800-555-0101",
      "email": "dispatch@midwestexpress.com",
      "contacts": [...],
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-29T14:20:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total": 1,
    "total_pages": 1,
    "has_more": false
  }
}