{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/shipping/bill-to-third-party","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/shipping/bill-to-third-party","default":false,"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":"a","attributes":{"href":"/apis/shipengine/docs/carriers/advanced-options"},"children":["advanced option"]},". To see if the carriers you use support third-party billing, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carrier-options"},"children":["list carriers options call"]}," 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":"a","attributes":{"href":"/apis/shipengine/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 /v1/labels"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /v1/labels HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"shipment\": {\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":["Note that the response does not include any advanced options object or related properties. While these values are sent to the carrier, they are not included in the response (though the resulting label will typically have an indication of 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.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.pdf\",\n    \"png\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.png\",\n    \"zpl\": \"https://api.shipengine.com/v1/downloads/6/Q2OLdnGaqk-UzkN6pFH0lg/testlabel-202923521.zpl\",\n    \"href\": \"https://api.shipengine.com/v1/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\": \"111111111111111111\",\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-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/shipping/bill-to-third-party","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}