---
title: "List Carriers"
method: GET
path: "/v1/carriers"
tags: ["carriers"]
---

# List Carriers

`GET /v1/carriers`

List all carriers that have been added to this account

## Response `200`

The request was a success.

- GetCarriersResponseBody — An error response body
  - `carriers` Carrier[], required — The carrier response body
    - `carrier_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
    - `carrier_code` string — A [shipping carrier](https://www.shipengine.com/docs/carriers/setup/), such as `fedex`, `dhl_express`, `stamps_com`, etc.
    - `account_number` string — The account number that the carrier is connected to.
    - `requires_funded_amount` boolean — Indicates whether the carrier requires funding to use its services
    - `balance` number — Current available balance
    - `nickname` string — Nickname given to the account when initially setting up the carrier.
    - `friendly_name` string — Screen readable name
    - `funding_source_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
    - `primary` boolean — Is this the primary carrier that is used by default when no carrier is specified in label/shipment creation
    - `has_multi_package_supporting_services` boolean — Carrier supports multiple packages per shipment
    - `allows_returns` boolean — The carrier has services that support return shipments.
    - `supports_label_messages` boolean — The carrier supports adding custom label messages to an order.
    - `disabled_by_billing_plan` boolean — The carrier is disabled by the current ShipEngine account's billing plan.
    - `services` Service[] — A list of services that are offered by the carrier
      - `carrier_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
      - `carrier_code` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
      - `service_code` string — service code
      - `name` string — User friendly service name
      - `domestic` boolean — Supports domestic shipping
      - `international` boolean — Supports international shipping.
      - `is_multi_package_supported` boolean — Carrier supports multiple packages per shipment
      - `is_return_supported` boolean — This service supports return shipments.
    - `packages` PackageType[] — A list of package types that are supported by the carrier
      - `package_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
      - `package_code` string, required — A [package type](https://www.shipengine.com/docs/reference/list-carrier-packages/), such as `thick_envelope`, `small_flat_rate_box`, `large_package`, etc. Use the code `package` for custom or unknown package types.
      - `name` string, required
      - `dimensions` Dimensions — The dimensions of a package
        - `unit` 'inch' | 'centimeter', required — The dimension units that are supported by ShipEngine.
        - `length` number, required — The length of the package, in the specified unit
        - `width` number, required — The width of the package, in the specified unit
        - `height` number, required — The height of the package, in the specified unit
      - `description` string, nullable — Provides a helpful description for the custom package.
    - `options` CarrierAdvancedOption[] — A list of options that are available to that carrier
      - `name` string — Name of advanced option
      - `default_value` string — Default value of option
      - `description` string — Description of option
    - `send_rates` boolean — The carrier provides rates for the shipment.
    - `supports_user_managed_rates` boolean — The carrier supports user-managed rates for shipments.
    - `connection_status` 'pending_approval' | 'approved' — The current connection status of the carrier. Indicates whether the carrier connection is pending approval or has been approved for use.
  - `request_id` string, uuid, required — A UUID (a.k.a. GUID) that uniquely identifies a resource
  - `errors` Error[], required — The errors associated with the failed API call
    - `error_source` 'carrier' | 'order_source' | 'shipengine', required — The source of the error, as indicated by the name this informs us if the API call failed because of the carrier, the order source, or the ShipEngine API itself.
    - `error_type` 'account_status' | 'business_rules' | 'validation' | 'security' | 'system' | 'integrations', required — The type of error
    - `error_code` 'auto_fund_not_supported' | 'batch_cannot_be_modified' | 'carrier_conflict' | 'carrier_disconnected' | 'carrier_not_connected' | 'carrier_not_supported' | 'confirmation_not_supported' | 'default_warehouse_cannot_be_deleted' | 'field_conflict' | 'field_value_required' | 'forbidden' | 'identifier_conflict' | 'identifiers_must_match' | 'insufficient_funds' | 'invalid_address' | 'invalid_billing_plan' | 'invalid_field_value' | 'invalid_identifier' | 'invalid_status' | 'invalid_string_length' | 'label_images_not_supported' | 'meter_failure' | 'order_source_not_active' | 'rate_limit_exceeded' | 'refresh_not_supported' | 'request_body_required' | 'return_label_not_supported' | 'settings_not_supported' | 'subscription_inactive' | 'terms_not_accepted' | 'tracking_not_supported' | 'trial_expired' | 'unauthorized' | 'unknown' | 'unspecified' | 'verification_failure' | 'warehouse_conflict' | 'webhook_event_type_conflict' | 'customs_items_required' | 'incompatible_paired_labels' | 'invalid_charge_event' | 'invalid_object' | 'no_rates_returned' | 'file_not_found' | 'shipping_rule_not_found' | 'service_not_determined' | 'no_rates_returned' | 'funding_source_registration_in_progress' | 'insurance_failure' | 'funding_source_missing_configuration' | 'funding_source_error', required — The error code specified for the failed API Call
    - `message` string, required — An error message associated with the failed API call
    - `carrier_id` string — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
    - `carrier_code` string — A [shipping carrier](https://www.shipengine.com/docs/carriers/setup/), such as `fedex`, `dhl_express`, `stamps_com`, etc.
    - `field_name` string — The name of the field that caused the error

## Other responses

- `207` — The request was a partial success. It contains results, as well as errors.
- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers.

---

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