Get Carrier

GET /v2/tms-api/carriers/{external_reference_id}

Retrieve details for a specific carrier using its external reference ID.

API Reference

Path Parameters

external_reference_idstringrequired

The carrier's external reference ID (from your system)

Request Example

curl -X GET "https://api.mentium.io/v2/tms-api/carriers/CARRIER-MIDWEST-001" \
  -H "X-API-Key: your_api_key_here"

Response

200 OK

{
  "id": "carrier_abc123def456",
  "external_reference_id": "CARRIER-MIDWEST-001",
  "name": "Midwest Express Trucking",
  "mc_number": "MC123456",
  "dot_number": "DOT789012",
  "phone_number": "800-555-0101",
  "email": "dispatch@midwestexpress.com",
  "contacts": [
    {
      "id": "contact_001",
      "first_name": "John",
      "last_name": "Driver",
      "primary_email": "john@midwestexpress.com",
      "primary_phone": "800-555-0102",
      "is_primary_contact": true
    }
  ],
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-29T14:20:00Z"
}

404 Not Found

{
  "detail": "Carrier with external_reference_id 'CARRIER-MIDWEST-001' not found"
}