{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/reference/get-carrier-by-id","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/reference/get-carrier-by-id","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/reference/get-carrier-by-id","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Get a Single Carrier","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":"get-a-single-carrier","__idx":0},"children":["Get a Single Carrier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint returns details about a specified ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/connect"},"children":["connected carrier account"]},", rather than listing all details for all connected carriers, as with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carriers"},"children":["List Carriers call"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this endpoint with the carrier's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," to retrieve details about a carrier's services, available options, available packages, and values for other carrier-specific properties."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request--response","__idx":1},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /v1/carriers/:carrier_id"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/carriers/se-123890 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":["Example Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response will include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_code"]},", the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["services"]}," object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages"]}," object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options"]}," object, and other properties related to this carrier."]},{"$$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  \"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  \"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    },\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    },\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    },\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    },\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    },\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    },\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    },\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    }\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","lang":"json"},"children":[]}]},"headings":[{"value":"Get a Single Carrier","id":"get-a-single-carrier","depth":1},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Get a Single Carrier"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/reference/get-carrier-by-id","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}