{"templateId":"markdown","versions":[{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/bill-to-third-party","default":false,"active":false,"folderId":"58c9a61d"},{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/docs/shipping/bill-to-third-party","default":true,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/shipping/bill-to-third-party","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Billing a Third Party","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":"billing-a-third-party","__idx":0},"children":["Billing a Third Party"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some carriers support billing shipping costs to a third party, which could be the recipient or some other entity. This feature is often useful for 3PLs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Billing to a third party is considered an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/advanced-options"},"children":["advanced option"]},". To see if the carriers you use support third-party billing, use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/openapi#tag/Carriers/operation/get-options-for-carrier"},"children":["get carrier options call"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/carriers/{carrier_id}/options"]},") for each carrier ID you wish to use."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must have the third party's account number (which you'll use as the value in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_account"]}," property).",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note that this requirement does not apply if you are using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/docs/carriers/fedex#fedex-ground-collect"},"children":["FedEx Ground Collect"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must include the following properties in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advanced_options"]}," object:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_country_code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_party"]}," (which should be set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["third_party"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_postal_code"]}]}]}]}]},{"$$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":["POST /v2/labels"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v2/labels HTTP/1.1\nHost: api.shipstation.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\n    \"carrier_id\": \"se-123890\",\n    \"service_code\": \"ups_ground\",\n    \"ship_to\": {\n      \"name\": \"Amanda Miller\",\n      \"phone\": \"555-555-5555\",\n      \"address_line1\": \"525 S Winchester Blvd\",\n      \"city_locality\": \"San Jose\",\n      \"state_province\": \"CA\",\n      \"postal_code\": \"95128\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"yes\"\n    },\n    \"ship_from\": {\n      \"company_name\": \"Example Corp.\",\n      \"name\": \"John Doe\",\n      \"phone\": \"111-111-1111\",\n      \"address_line1\": \"4009 Marathon Blvd\",\n      \"address_line2\": \"Suite 300\",\n      \"city_locality\": \"Austin\",\n      \"state_province\": \"TX\",\n      \"postal_code\": \"78756\",\n      \"country_code\": \"US\",\n      \"address_residential_indicator\": \"no\"\n    },\n    \"packages\": [\n      {\n        \"weight\": {\n          \"value\": 1.0,\n          \"unit\": \"ounce\"\n        }\n      }\n    ],\n    \"advanced_options\": {\n      \"bill_to_account\": \"123456789\",\n      \"bill_to_country_code\": \"US\",\n      \"bill_to_party\": \"third_party\",\n      \"bill_to_postal_code\": \"78756\"\n    }\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The label response does not include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bill_to_*"]}," advanced option properties. While these values are sent to the carrier, they are not returned (though the resulting label will typically indicate the options added to the shipment)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"label_id\": \"se-57064247\",\n  \"status\": \"completed\",\n  \"shipment_id\": \"se-150849648\",\n  \"ship_date\": \"2019-07-25T05:00:00.000Z\",\n  \"created_at\": \"2019-07-25T15:24:46.657Z\",\n  \"shipment_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.00\n  },\n  \"insurance_cost\": {\n    \"currency\": \"usd\",\n    \"amount\": 0.0\n  },\n  \"tracking_number\": \"787943902587\",\n  \"is_return_label\": false,\n  \"is_international\": false,\n  \"batch_id\": \"\",\n  \"carrier_id\": \"se-123890\",\n  \"service_code\": \"ups_ground\",\n  \"package_code\": \"package\",\n  \"voided\": false,\n  \"voided_at\": null,\n  \"label_format\": \"pdf\",\n  \"label_layout\": \"4x6\",\n  \"trackable\": true,\n  \"carrier_code\": \"ups\",\n  \"tracking_status\": \"in_transit\",\n  \"label_download\": {\n    \"pdf\": \"https://api.shipstation.com/v2/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf\",\n    \"png\": \"https://api.shipstation.com/v2/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.png\",\n    \"zpl\": \"https://api.shipstation.com/v2/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.zpl\",\n    \"href\": \"https://api.shipstation.com/v2/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf\"\n  },\n  \"form_download\": null,\n  \"insurance_claim\": null,\n  \"packages\": [\n    {\n      \"package_code\": \"package\",\n      \"weight\": {\n        \"value\": 1.00,\n        \"unit\": \"ounce\"\n      },\n      \"dimensions\": {\n        \"unit\": \"inch\",\n        \"length\": 0.0,\n        \"width\": 0.0,\n        \"height\": 0.0\n      },\n      \"insured_value\": {\n        \"currency\": \"usd\",\n        \"amount\": 0.00\n      },\n      \"tracking_number\": \"787943902587\",\n      \"label_messages\": {\n        \"reference1\": null,\n        \"reference2\": null,\n        \"reference3\": null\n      }\n    }\n  ]\n}\n","lang":"json"},"children":[]}]},"headings":[{"value":"Billing a Third Party","id":"billing-a-third-party","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":2}],"frontmatter":{"seo":{"title":"Billing a Third Party"}},"lastModified":"2026-10-02T21:56:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/docs/shipping/bill-to-third-party","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}