{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/list-carriers","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/list-carriers","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/list-carriers","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"List Carriers","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"list-carriers","__idx":0},"children":["List Carriers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint returns a list of all your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/connect"},"children":["connected carrier accounts"]},", along with helpful information about each account, its options, the services it offers, etc."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request these details for a specific carrier, rather than all carriers, add the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," to the endpoint. See our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/get-carrier-by-id"},"children":["Get a Single Carrier reference"]}," for details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"carrier-ids","__idx":1},"children":["Carrier IDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of the most important pieces of information in the List Carriers response is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},". Each of your carriers has a unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},", which you'll use to specify the carrier account for many ShipStation API endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/labels/create-a-label"},"children":["creating a label"]},", you'll explicitly specify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," for the account the label should come from. Similarly, when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/rates/rates"},"children":["calculating shipping costs"]},", you may want to specify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," of the account that you know has the best rates for the type of package."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":2},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v1/carriers/"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/carriers HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Some carriers may include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connection_status"]}," field indicating the approval state of the carrier connection. Possible values are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["approved"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending_approval"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"carriers\": [\n    {\n      \"carrier_id\": \"se-123890\",\n      \"carrier_code\": \"stamps_com\",\n      \"account_number\": null,\n      \"requires_funded_amount\": true,\n      \"balance\": 0.0,\n      \"nickname\": \"Free\",\n      \"friendly_name\": \"Stamps.com\",\n      \"primary\": true,\n      \"has_multi_package_supporting_services\": false,\n      \"services\": [\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_first_class_mail\",\n          \"name\": \"USPS First Class Mail\",\n          \"domestic\": true,\n          \"international\": false,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_media_mail\",\n          \"name\": \"USPS Media Mail\",\n          \"domestic\": true,\n          \"international\": false,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_parcel_select\",\n          \"name\": \"USPS Parcel Select Ground\",\n          \"domestic\": true,\n          \"international\": false,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_priority_mail\",\n          \"name\": \"USPS Priority Mail\",\n          \"domestic\": true,\n          \"international\": false,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_priority_mail_express\",\n          \"name\": \"USPS Priority Mail Express\",\n          \"domestic\": true,\n          \"international\": false,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_first_class_mail_international\",\n          \"name\": \"USPS First Class Mail Intl\",\n          \"domestic\": false,\n          \"international\": true,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_priority_mail_international\",\n          \"name\": \"USPS Priority Mail Intl\",\n          \"domestic\": false,\n          \"international\": true,\n          \"is_multi_package_supported\": false\n        },\n        {\n          \"carrier_id\": \"se-123890\",\n          \"carrier_code\": \"stamps_com\",\n          \"service_code\": \"usps_priority_mail_express_international\",\n          \"name\": \"USPS Priority Mail Express Intl\",\n          \"domestic\": false,\n          \"international\": true,\n          \"is_multi_package_supported\": false\n        }\n      ],\n      \"packages\": [\n        {\n          \"package_id\": null,\n          \"package_code\": \"flat_rate_envelope\",\n          \"name\": \"Flat Rate Envelope\",\n          \"description\": \"USPS flat rate envelope. A special cardboard envelope provided by the USPS that clearly indicates Flat Rate.\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"flat_rate_legal_envelope\",\n          \"name\": \"Flat Rate Legal Envelope\",\n          \"description\": \"Flat Rate Legal Envelope\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"flat_rate_padded_envelope\",\n          \"name\": \"Flat Rate Padded Envelope\",\n          \"description\": \"Flat Rate Padded Envelope\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"large_envelope_or_flat\",\n          \"name\": \"Large Envelope or Flat\",\n          \"description\": \"Large envelope or flat. Has one dimension that is between 11 1/2 and 15 long, 6 1/18 and 12 high, or 1/4 and 3/4 thick.\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"large_flat_rate_box\",\n          \"name\": \"Large Flat Rate Box\",\n          \"description\": \"Large Flat Rate Box\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"large_package\",\n          \"name\": \"Large Package (any side > 12)\",\n          \"description\": \"Large package. Longest side plus the distance around the thickest part is over 84 and less than or equal to 108.\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"letter\",\n          \"name\": \"Letter\",\n          \"description\": \"Letter\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"medium_flat_rate_box\",\n          \"name\": \"Medium Flat Rate Box\",\n          \"description\": \"USPS flat rate box. A special 11 x 8 1/2 x 5 1/2 or 14 x 3.5 x 12 USPS box that clearly indicates Flat Rate Box\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"package\",\n          \"name\": \"Package\",\n          \"description\": \"Package. Longest side plus the distance around the thickest part is less than or equal to 84\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"regional_rate_box_a\",\n          \"name\": \"Regional Rate Box A\",\n          \"description\": \"Regional Rate Box A\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"regional_rate_box_b\",\n          \"name\": \"Regional Rate Box B\",\n          \"description\": \"Regional Rate Box B\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"small_flat_rate_box\",\n          \"name\": \"Small Flat Rate Box\",\n          \"description\": \"Small Flat Rate Box\"\n        },\n        {\n          \"package_id\": null,\n          \"package_code\": \"thick_envelope\",\n          \"name\": \"Thick Envelope\",\n          \"description\": \"Thick envelope. Envelopes or flats greater than 3/4 at the thickest point.\"\n        }\n      ],\n      \"options\": [],\n      \"send_rates\": false,\n      \"supports_user_managed_rates\": false,\n      \"connection_status\": \"approved\"\n    }\n  ],\n  \"request_id\": \"fd27e4f2-4dfb-4963-ad46-e6b4f1658439\",\n  \"errors\": []\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"List Carriers","id":"list-carriers","depth":1},{"value":"Carrier IDs","id":"carrier-ids","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"List Carriers"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/list-carriers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}