---
title: "Get carrier by ID"
method: GET
path: "/v1/carriers/{carrierId}"
tags: ["Carrier Management"]
---

# Get carrier by ID

`GET /v1/carriers/{carrierId}`

## Request

- Base URL: `https://api.prod.goaugment.com`
- URL: `https://api.prod.goaugment.com/v1/carriers/{carrierId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/goaugment/apis/augment-api/docs/v1/carriers/:carrierId/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch a carrier by its carrier ID. Returns the carrier with associated managers and contacts.

## Path parameters

- `carrierId` string, required

## Response `200`

Carrier found

- CarrierResponse
  - `id` string: Carrier ID (ULID)
  - `name` string: Carrier name
  - `tmsId` string, nullable: TMS identifier for the carrier
  - `status` object, nullable: Carrier status
    - `code` 'ACTIVE' | 'DO_NOT_USE': Status code indicating the carrier's current state
    - `reason` string, nullable: Optional reason for the status
  - `complianceStatus` object, nullable: Compliance status information
    - `codes` object: Compliance codes as key-value pairs
  - `mcNumber` integer, nullable: MC number
  - `dotNumber` integer, nullable: DOT number
  - `scac` string, nullable: SCAC code
  - `address` object, nullable: Carrier address
    - `street1` string: Street address line 1
    - `street2` string, nullable: Street address line 2
    - `city` string: City name
    - `stateOrProvince` string, nullable: State or province code
    - `postalCode` string: Postal or ZIP code
    - `country` string: Country code (2-letter ISO)
    - `name` string, nullable: Location name
    - `company` string, nullable: Company name
  - `email` string, nullable: Carrier email address
  - `phone` string, nullable: Phone number in E.164 format (e.g., +13125551234)
  - `phoneExtension` string, nullable: Phone extension
  - `managers` BrokerageContactResponse[]: Array of organization contacts (managers) who manage this carrier
    - `id` string: Organization contact ID (ULID)
    - `name` string, nullable: Contact name
    - `tmsId` string, nullable: TMS identifier for the contact
    - `roles` string[]: The employee's role(s) on each load. Possible values: `CARRIER_REP` — rep who gets commission credit for the load, `OPERATIONS_REP` — manages day-to-day operations on the load, `OPERATIONS_MANAGER` — brokerage-side manager or supervisor, `ACCOUNT_MANAGER` — manages the customer relationship, `CUSTOMER_REP` — sales rep to the customer, `CUSTOMER_TEAM` — part of the broader customer team, `CARRIER_TEAM` — team responsible for carrier-facing operations and relationships, `BOOKED_BY` — party who booked the load, `AP_REP` — Accounts Payable Specialist, who manages invoice and payment processes, `AFTER_HOURS_REP` — contact available outside of regular business hours.
    - `preferredContactMode` 'EMAIL' | 'PHONE_CALL' | 'TEXT_MESSAGE' | 'TELEGRAM', nullable: Preferred method of contact
    - `email` string, nullable: Contact email address
    - `phone` string, nullable: Phone number in E.164 format (e.g., +13125551234)
    - `phoneExtension` string, nullable: Phone extension
  - `contacts` CarrierContactResponse[]: Array of carrier contacts (carrier employees)
    - `id` string: Carrier contact ID (ULID)
    - `name` string, nullable: Contact name
    - `tmsId` string, nullable: TMS identifier for the contact
    - `roles` string[]: Carrier contact roles: - `ACCOUNTANT` — Accountant - `AP_REP` — manages invoices and payments - `DISPATCHER` — Dispatcher - `AFTER_HOURS_DISPATCHER` — dispatcher to contact outside of regular business hours - `WEEKEND_DISPATCHER` — dispatcher to contact on weekends - `BOOKING` — handles load booking - `TRACKING` — handles load tracking - `DRIVER` — Driver - `OTHER` — Other
    - `preferredContactMode` 'EMAIL' | 'PHONE_CALL' | 'TEXT_MESSAGE' | 'TELEGRAM', nullable: Preferred method of contact
    - `email` string, nullable: Contact email address
    - `phone` string, nullable: Phone number in E.164 format (e.g., +13125551234)
    - `phoneExtension` string, nullable: Phone extension
  - `notes` string, nullable: Free-form notes about the carrier
  - `customData` CarrierCustomData: Optional metadata for the carrier. Use string keys; each value may be a string, number, boolean, array of JSON-safe values, or nested object with the same rules. Omit or send `{}` when you have nothing to store.

## Other responses

- `401`: Unauthorized
- `404`: Carrier not found

---

[API](https://skmtc.dev/goaugment/apis/augment-api.md) - [All operations](https://skmtc.dev/goaugment/apis/augment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/augment-api/revisions/b61097634d79?raw)