account6

addresses1

batches12

carriers7

checkout_rates9

connections4

delivery_predictions1

documents9

downloads1

freight12

fulfillments2

inventory12

labels13

mailing3

manifests4

package_pickups4

package_types5

products5

purchase_orders9

rate_shoppers2

rates4

service_points2

shipments18

suppliers4

tags5

tokens1

totes6

tracking3

users1

warehouses6

webhooks5

carriers

List carriers

Changed on Oct 22, 2026

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

List all carriers that have been added to this account.

get/v2/carriers

Request

Base URL
https://api.shipstation.com
URL
https://api.shipstation.com/v2/carriers
Auth
API key in header api-key

Query parameters

pageinteger

Return a specific page of results. Defaults to the first page. If set to a number that's greater than the number of pages of results, an empty page is returned.

page_sizeinteger

The number of results to return per response.

include_extended_detailsboolean

When true (the default), each carrier in the response includes two additional arrays: packages (the package types supported by that carrier) and options (the carrier-level advanced options available for that carrier). Set to false to omit both arrays and reduce response payload size. This is useful when you only need basic carrier information such as carrier_id, balance, or services.

Response

The request was a success.

totalinteger required

The total number of items across all pages of results

pageinteger required

The current page number of results. For example, if there are 80 results, and the page size is 25, then page could be 1, 2, 3, or 4. The first three pages would contain 25 items each, and the fourth page would contain the five remaining items.

pagesinteger required

The total number of pages of results. For example, if there are 80 results, and the page size is 25, then pages would be 4. The first three pages would contain 25 items each, and the fourth page would contain the five remaining items. If there are no results, then pages will be zero.

request_idstring uuid required

A UUID (a.k.a. GUID) that uniquely identifies a resource

Example response

{
  "carriers": [
    {
      "carrier_id": "se-28529731",
      "carrier_code": "dhl_express",
      "account_number": "account_570827",
      "connection_status": "approved",
      "requires_funded_amount": true,
      "balance": 3799.52,
      "nickname": "ShipStation Account - Stamps.com",
      "friendly_name": "Stamps.com",
      "funding_source_id": "se-28529731",
      "primary": true,
      "has_multi_package_supporting_services": true,
      "supports_label_messages": true,
      "disabled_by_billing_plan": true,
      "services": [
        {
          "carrier_id": "se-28529731",
          "carrier_code": "se-28529731",
          "service_code": "usps_media_mail",
          "name": "USPS First Class Mail",
          "domestic": true,
          "international": true,
          "is_multi_package_supported": true,
          "send_rates": true
        }
      ],
      "packages": [
        {
          "package_id": "se-28529731",
          "package_code": "small_flat_rate_box",
          "name": "laptop_box",
          "dimensions": {
            "length": 2,
            "width": 2,
            "height": 1
          },
          "description": "Packaging for laptops"
        }
      ],
      "options": [
        {
          "name": "contains_alcohol",
          "default_value": "false",
          "description": "The description"
        }
      ],
      "send_rates": true,
      "supports_user_managed_rates": true
    }
  ],
  "total": 2750,
  "page": 1,
  "pages": 4,
  "links": {
    "first": {
      "href": "https://example.com/resource",
      "type": "child"
    },
    "last": {
      "href": "https://example.com/resource",
      "type": "child"
    },
    "prev": {
      "href": "https://example.com/resource",
      "type": "child"
    },
    "next": {
      "href": "https://example.com/resource",
      "type": "child"
    }
  },
  "request_id": "aa3d8e8e-462b-4476-9618-72db7f7b7009",
  "errors": [
    {
      "message": "Body of request cannot be null.",
      "field_name": "inventory_warehouse_id",
      "field_value": "invalid-id"
    }
  ]
}

Changes

Oct 22, 20264e29670aa28d Revision changes
- warning
  added the new bring_your_own_label_not_supported enum value to the /// response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the /// response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new bring_your_own_label_not_supported enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the /// response property for the response status
- warning
  added the new multiple_sales_orders enum value to the /// response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new multiple_sales_orders enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the /// response property for the response status
- warning
  added the new sales_order_link_required enum value to the /// response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
- warning
  added the new sales_order_link_required enum value to the // response property for the response status
Oct 16, 2026bf3618aaf7e1 Revision changes
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property /////// became nullable for the status
- breaking
  the response property /////// became nullable for the status
- breaking
  added subschema #2 to the //// response property oneOf list for the response status
- breaking
  added subschema #2 to the //// response property oneOf list for the response status
- info
  removed from the //// response property allOf list for the response status
- info
  removed from the //// response property allOf list for the response status

Operation history (5 revisions)