# List Carriers

The `/v2/carriers` endpoint can return a lot of useful information about the carriers available to your account. The most important of which is the `carrier_id`. Each of your carriers has a unique `carrier_id`, which you'll use to specify the carrier account for many commonly used endpoints.

For example, when [purchasing a label](/create-labels), you'll explicitly specify the `carrier_id` for the account the label should come from. Similarly, when [rate shopping](/rate-shopping), you may want to specify the `carrier_id` of the account that you know has the best rates for the type of package you are shipping.

You can also use this endpoint in a few different ways, depending on what you need:

- **List Carriers**: Returns a list of all your available carriers and their details (including `carrier_id`, `carrier_code`, `account_number`), a list of all the carriers’ available services and their attributes, a list of the carriers’ available package types and their attributes, and a list of all the carriers’ available options.
- **Get a single carrier**: Returns a list of services, package types, and options for the specified `carrier_id`.
- **List Carrier Services**: Returns a list of services and service attributes for the specified `carrier_id`.
- **List Carrier Package Types**: Returns a list of available package types for the specified `carrier_id`.
- **List Carrier Options**: Returns a list of the available advanced options for a specified `carrier_id`. Advanced options include the ability to ship alcohol or dangerous goods, bill to a third-party account, and much more.


## Requirements

- You’ll need the `carrier_id` for all except the List Carriers call.


## List Carriers: Sample Request

**GET /v2/carriers/**

Depending on how many carriers you have connected to your account, the response can be quite long, as it includes all services, package types, and options available for each carrier. This sample response is truncated to a single carrier with its package types and options (in this case, no options are available for this carrier).


```

```

## Get a Single Carrier: Sample Request

**GET /v2/carriers/:carrier_id**


```

```

## List Carrier Services: Sample Request

**GET /v2/carriers/:carrier_id/services**


```

```

## List Carrier Package Types: Sample Request

**GET /v2/carriers/:carrier_id/packages**


```

```

## List Carrier Options: Sample Request

This example uses UPS as the carrier since UPS offers a wide variety (but not an exhaustive list) of potential advanced options.

**GET /v2/carriers/:carrier_id/options**


```

```