---
title: "Get carrier by id"
method: GET
path: "/v2/carriers/{carrier_id}"
tags: ["carriers"]
---

# Get carrier by id

`GET /v2/carriers/{carrier_id}`

<aside class="access" aria-label="Endpoint access">
      <table class="access__table">
        <thead>
          <tr>
            <th class="access__table-header">Products</th>
            <th class="access__table-header">Plans</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td class="access__table-cell access__product">
              <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/>
              <div class="access__sub">Formerly ShipEngine</div>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a>
            </td>
          </tr>
          <tr>
            <td class="access__table-cell">
              <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a>
            </td>
          </tr>
        </tbody>
      </table>
      <footer class="access__footer">
        <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md">
          Learn about products and plans
          <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/>
        </a>
      </footer>
    </aside>

Retrive details about a specific carrier by its carrier 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 ShipStation resource, such as a carrier, label, shipment, etc.
  - `carrier_code` string — A [shipping carrier] , such as `fedex`, `dhl_express`, `stamps_com`, etc.
  - `account_number` string — The account number that the carrier is connected to.
  - `connection_status` 'pending_approval' | 'approved' — The connection status of the carrier account. Indicates whether the carrier connection is pending approval or has been approved. This only applies to certain carriers; it can be undefined.
  - `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 ShipStation 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
  - `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 ShipStation 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 ShipStation resource, such as a carrier, label, shipment, etc.
    - `carrier_code` string — A string that uniquely identifies a ShipStation 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
    - `send_rates` boolean — The service provides rates for the shipment.
  - `packages` PackageType[] — A list of package types that are supported by the carrier
    - `package_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.
    - `package_code` string, required — A [package type] , 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 ShipStation .
      - `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 — 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.

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — The request was successful.

---

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