---
title: "Get Carrier"
method: GET
path: "/v2/mentium-tms/carriers/{carrier_id}"
tags: ["v2", "mentium-tms", "carriers"]
---

# Get Carrier

`GET /v2/mentium-tms/carriers/{carrier_id}`

## 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/{carrier_id}`
- Auth: HTTP bearer

Get a single MentiumTMS carrier by ID with all details, including observer
provenance (which organizations/integration_connections observed this carrier).

## Path parameters

- `carrier_id` string, required

## Query parameters

- `include` string, nullable: Comma-separated includes

## Response `200`

Successful Response

- MentiumTmsCarrierDetailSchema
  - `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
  - `operating_scope_us` string, nullable
  - `operating_scope_mx` string, nullable
  - `common_authority_status` string, nullable
  - `common_authority_grant_date` string, date-time, nullable
  - `contract_authority_status` string, nullable
  - `contract_authority_grant_date` string, date-time, nullable
  - `out_of_service_date` string, date-time, nullable
  - `cargo_types` string[]
  - `hazmat_supported` boolean, nullable
  - `power_units` integer, nullable
  - `total_drivers` integer, nullable
  - `bipd_insurance_on_file_1000` integer, nullable
  - `cargo_insurance_on_file` boolean, nullable
  - `bond_surety_on_file` boolean, nullable
  - `safety_rating` string, nullable
  - `safety_rating_date` string, date-time, nullable
  - `mcs150_date` string, date-time, nullable
  - `mcs150_mileage` integer, nullable
  - `mcs150_mileage_year` integer, nullable
  - `mentium_data_origins` string[]
  - `observations` MentiumTmsCarrierObservationSchema[]
    - `organization_id` string, required
    - `integration_connection_id` string, nullable
    - `last_observed_at` string, date-time, nullable

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