---
title: "Get Carrier By ID"
method: GET
path: "/v1/carriers/{carrier_id}"
tags: ["carriers"]
---

# Get Carrier By ID

`GET /v1/carriers/{carrier_id}`

Retrive carrier info by ID

## Response `200`

The request was a success.

- GetCarrierByIdResponseBody — A carrier object that represents a provider such as UPS, USPS, DHL, etc that has been tied to the current account.
  - `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.

## Other responses

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