---
title: "List Carriers"
method: GET
path: "/public/v3/Carriers"
tags: ["Carriers"]
---

# List Carriers

`GET /public/v3/Carriers`

List all carriers within the specified account.

## Query parameters

- `Name` string
- `Mode` 'Road' | 'Ocean' | 'Air' | 'Rail' — The mode of transportation. Valid modes are `Road`, `Ocean`, `Air`, or `Rail`.
- `PageSize` integer
- `PageNumber` integer

## Headers

- `x-tive-account-id` integer, required

## Response `200`

The requested carriers

- CarrierResponsePaginatedResponse
  - `totalRecords` integer
  - `pageNumber` integer
  - `pageSize` integer
  - `data` CarrierResponse[], nullable
    - `carrierId` string, uuid
    - `accountId` integer
    - `name` string, nullable
    - `mode` 'Road' | 'Ocean' | 'Air' | 'Rail' — The mode of transportation. Valid modes are `Road`, `Ocean`, `Air`, or `Rail`.
    - `carrierContacts` CarrierContactResponse[], nullable
      - `carrierContactId` string, uuid, nullable
      - `carrierId` string, uuid, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, nullable
      - `phoneNumber` string, nullable
      - `language` string, nullable
    - `standardizedCarrierId` string, uuid
    - `standardizedCarrierName` string, nullable
    - `areaOfOperation` 'UnitedStates' | 'RestOfTheWorld' — Area of Operation of the Carrier. Valid values are `UnitedStates`, `RestOfTheWorld`.
    - `dotNumber` string, nullable
    - `mcNumber` string, nullable
  - `next` string, nullable
  - `previous` string, nullable

## Other responses

- `400` — The requested carriers are not available
- `401` — Unauthorized

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/revisions/9a8d869e3cdc/schema)
