---
title: "List Carriers"
method: GET
path: "/v2/mentium-tms/carriers"
tags: ["v2", "mentium-tms", "carriers"]
---

# List Carriers

`GET /v2/mentium-tms/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/mentium-tms/carriers`
- Auth: HTTP bearer

List MentiumTMS carriers with free-text search and pagination.

## Query parameters

- `query` string, nullable: Free-text search (name, DOT, MC, phone, email, city, state)
- `limit` integer: Page size
- `offset` integer: Pagination offset
- `sort_by` string, nullable: Sort by: legal_name, dot_number, mc_number, relevance
- `sort_order` string, nullable: Sort order: asc, desc
- `include` string, nullable: Comma-separated includes: contacts, addresses, certifications

## Response `200`

Successful Response

- ListMentiumTmsCarriersResponseSchema
  - `carriers` MentiumTmsCarrierSchema[]
    - `id` string, required
    - `legal_name` string, nullable
    - `dba_name` string, nullable
    - `dot_number` string, nullable
    - `mc_number` string, nullable
    - `service_status` string, nullable
    - `equipment_types` string[]
    - `contacts` MentiumTmsCarrierContactSchema[]
      - `id` string, required
      - `mentium_tms_carrier_id` string, nullable
      - `contact_type` string, nullable
      - `name` string, nullable
      - `job_title` string, nullable
      - `phone_numbers` string[]
      - `fax_numbers` string[]
      - `email_addresses` string[]
      - `last_observed_at` string, date-time, nullable
    - `addresses` MentiumTmsCarrierAddressSchema[]
      - `id` string, required
      - `mentium_tms_carrier_id` string, nullable
      - `address_type` string, nullable
      - `name` string, nullable
      - `address_line1` string, nullable
      - `address_line2` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
      - `country` string, nullable
      - `last_observed_at` string, date-time, nullable
    - `certifications` MentiumTmsCarrierCertificationSchema[]
      - `id` string, required
      - `mentium_tms_carrier_id` string, nullable
      - `certification_type` string, nullable
      - `certification_number` string, nullable
      - `effective_at` string, date-time, nullable
      - `expiration_at` string, date-time, nullable
  - `total_count` integer
  - `has_more` boolean

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