Returns one or more shipping labels associated with an OpenBorder order.
For full-order fulfillment, provide the order number to retrieve the
existing label. For split shipments, include the required SKU, parcel,
and address information to generate a label for the specified items.
When true, the response includes a URL to the label in ZPL format for thermal printers.
Response
Request processed. result is the label when one was found or generated.
When the order can't be matched, result is the string
Unable to generate label and isError is still false.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"OpenBorder API Documentation","colors":{"primary":"#0540f4","light":"#070707","dark":"#051130"},"logo":{"light":"https://mintcdn.com/openborder-2b51b6dd/S0NizTekLQ6ttVRZ/images/Logo-48px.png?fit=max\u0026auto=format\u0026n=S0NizTekLQ6ttVRZ\u0026q=85\u0026s=bce3b91de865573b8550ef923ea21b25","dark":"https://mintcdn.com/openborder-2b51b6dd/S0NizTekLQ6ttVRZ/images/Logo-48px.png?fit=max\u0026auto=format\u0026n=S0NizTekLQ6ttVRZ\u0026q=85\u0026s=bce3b91de865573b8550ef923ea21b25"},"favicon":"https://mintcdn.com/openborder-2b51b6dd/ZfGRmbNr7AFdJzOY/images/favicon.png?fit=max\u0026auto=format\u0026n=ZfGRmbNr7AFdJzOY\u0026q=85\u0026s=0bff9fc4120aee640ae1aca8104bb2a6","appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"mailto:richard@openborder.com","label":"Support"}],"primary":{"type":"button","label":"Get Access","href":"https://openborder.com"}},"footer":{"socials":{}},"fonts":{"family":"DM Sans"},"styling":{"codeblocks":"system","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"openborder-2b51b6dd","hasAudioNarration":false,"actualSubdomain":"openborder-2b51b6dd","customDomains":["developers.openborder.com"],"gitSource":{"type":"gitlab","owner":"pangaea-holdings","repo":"openborder-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"projectId":86063915,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aedfbbded2e00f2f0020b1b","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Integration Guides","count":7},{"language":"default","tag":"Landed Cost Integration","count":3},{"language":"default","tag":"Tracking","count":3},{"language":"default","tag":"Landed Cost","count":2},{"language":"default","tag":"Orders","count":2},{"language":"default","tag":"Get Started","count":1},{"language":"default","tag":"Label Compliance","count":1},{"language":"default","tag":"Shipping Labels","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/shipping-labels/get-label","slug":"/api-reference/shipping-labels/get-label","pageMetadata":{"title":"Get Label","description":"Returns one or more shipping labels associated with an OpenBorder order.\n\nFor full-order fulfillment, provide the order number to retrieve the\nexisting label. For split shipments, include the required SKU, parcel,\nand address information to generate a label for the specified items.\n","deprecated":null,"version":null,"openapi":"/api-reference/shipping-labels.yaml post /api/post/fc/labels","href":"/api-reference/shipping-labels/get-label","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Returns one or more shipping labels associated with an OpenBorder order.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"For full-order fulfillment, provide the order number to retrieve the\\nexisting label. For split shipments, include the required SKU, parcel,\\nand address information to generate a label for the specified items.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get Label","description":"Returns one or more shipping labels associated with an OpenBorder order.\n\nFor full-order fulfillment, provide the order number to retrieve the\nexisting label. For split shipments, include the required SKU, parcel,\nand address information to generate a label for the specified items.\n","deprecated":null,"version":null,"openapi":"/api-reference/shipping-labels.yaml post /api/post/fc/labels","href":"/api-reference/shipping-labels/get-label","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getLabel","tags":["Shipping Labels"],"summary":"Get Label","description":"Returns one or more shipping labels associated with an OpenBorder order.\n\nFor full-order fulfillment, provide the order number to retrieve the\nexisting label. For split shipments, include the required SKU, parcel,\nand address information to generate a label for the specified items.\n","requestBody":"02d33b7c-8cad-4ebf-8592-56f43c6171ad","responses":{"200":"95981475-402b-42e3-be47-feffc7cc0ae9","400":"fb31ecca-e5dd-459a-a817-260bf645fe00","401":"9be06caf-0dc6-46b5-80c7-aaaebfac942b"},"method":"post","type":"path","servers":["a7491433-2028-43d2-80a5-a32e33335046"],"security":["28d00a13-bad6-4f4d-a94a-5e95077837f0"],"path":"/api/post/fc/labels","baseUrlOptions":["https://api.openborder.com"],"title":"Get Label","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["orderNumber"],"properties":{"orderNumber":{"type":"string","description":"The order number to retrieve or generate a label for.","isRequired":true,"uniqueKey":"orderNumber","typeLabel":"string"},"weight":{"type":"number","description":"Parcel weight. When provided, weightUnit is also required.","uniqueKey":"weight","typeLabel":"number"},"weightUnit":{"type":"string","enum":["grams","pounds"],"description":"Unit for the weight field. Required when weight is set.","uniqueKey":"weightUnit","typeLabel":"enum\u003cstring>"},"length":{"type":"number","description":"Parcel length. When any dimension is provided, dimensionsUnit is also required.","uniqueKey":"length","typeLabel":"number"},"width":{"type":"number","description":"Parcel width. When any dimension is provided, dimensionsUnit is also required.","uniqueKey":"width","typeLabel":"number"},"height":{"type":"number","description":"Parcel height. When any dimension is provided, dimensionsUnit is also required.","uniqueKey":"height","typeLabel":"number"},"dimensionsUnit":{"type":"string","enum":["cm","in"],"description":"Unit for length, width, and height. Required when any dimension is set.","uniqueKey":"dimensionsUnit","typeLabel":"enum\u003cstring>"},"base64":{"type":"boolean","description":"When true, the label is returned as a base64-encoded string in addition to the PDF URL.","uniqueKey":"base64","typeLabel":"boolean"},"skus":{"type":"array","description":"Required for partial label generation. An array of SKU objects describing the items in this parcel.","items":{"type":"object","required":["skuName","asn","quantity"],"properties":{"skuName":{"type":"string","description":"The SKU identifier.","isRequired":true,"uniqueKey":"skus.items.[INDEX].skuName","typeLabel":"string"},"asn":{"type":"string","description":"The Advanced Shipment Notice (ASN) reference associated with the SKU.","isRequired":true,"uniqueKey":"skus.items.[INDEX].asn","typeLabel":"string"},"quantity":{"type":"number","description":"Quantity of this SKU included in the parcel.","isRequired":true,"uniqueKey":"skus.items.[INDEX].quantity","typeLabel":"number"}},"uniqueKey":"skus.items.[INDEX]","typeLabel":"object"},"uniqueKey":"skus","typeLabel":"object[]"},"fromAddress":{"type":"object","description":"The origin address. Required when skus is provided.","required":["firstName","lastName","phoneNumber","line1","city","province","country","zipcode"],"properties":{"firstName":{"type":"string","description":"First name on the address.","isRequired":true,"uniqueKey":"fromAddress.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name on the address.","isRequired":true,"uniqueKey":"fromAddress.lastName","typeLabel":"string"},"phoneNumber":{"type":"string","description":"Phone number including country code.","isRequired":true,"uniqueKey":"fromAddress.phoneNumber","typeLabel":"string"},"line1":{"type":"string","description":"Primary street address line.","isRequired":true,"uniqueKey":"fromAddress.line1","typeLabel":"string"},"city":{"type":"string","description":"City name.","isRequired":true,"uniqueKey":"fromAddress.city","typeLabel":"string"},"province":{"type":"string","description":"State or province code.","isRequired":true,"uniqueKey":"fromAddress.province","typeLabel":"string"},"country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code, such as US or DE.","pattern":"^[A-Z]{2}$","isRequired":true,"uniqueKey":"fromAddress.country","typeLabel":"string"},"zipcode":{"type":"string","description":"Postal or ZIP code.","isRequired":true,"uniqueKey":"fromAddress.zipcode","typeLabel":"string"},"line2":{"type":"string","description":"Secondary address line (apartment, suite, unit, etc.).","uniqueKey":"fromAddress.line2","typeLabel":"string"}},"uniqueKey":"fromAddress","typeLabel":"object"},"toAddress":{"type":"object","description":"The destination address. Required when skus is provided.","required":["firstName","lastName","phoneNumber","line1","city","province","country","zipcode"],"properties":{"firstName":{"type":"string","description":"First name on the address.","isRequired":true,"uniqueKey":"toAddress.firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name on the address.","isRequired":true,"uniqueKey":"toAddress.lastName","typeLabel":"string"},"phoneNumber":{"type":"string","description":"Phone number including country code.","isRequired":true,"uniqueKey":"toAddress.phoneNumber","typeLabel":"string"},"line1":{"type":"string","description":"Primary street address line.","isRequired":true,"uniqueKey":"toAddress.line1","typeLabel":"string"},"city":{"type":"string","description":"City name.","isRequired":true,"uniqueKey":"toAddress.city","typeLabel":"string"},"province":{"type":"string","description":"State or province code.","isRequired":true,"uniqueKey":"toAddress.province","typeLabel":"string"},"country":{"type":"string","description":"Two-letter ISO 3166-1 alpha-2 country code, such as US or DE.","pattern":"^[A-Z]{2}$","isRequired":true,"uniqueKey":"toAddress.country","typeLabel":"string"},"zipcode":{"type":"string","description":"Postal or ZIP code.","isRequired":true,"uniqueKey":"toAddress.zipcode","typeLabel":"string"},"line2":{"type":"string","description":"Secondary address line (apartment, suite, unit, etc.).","uniqueKey":"toAddress.line2","typeLabel":"string"}},"uniqueKey":"toAddress","typeLabel":"object"},"trackReference":{"type":"string","description":"A reference string printed directly on the label. Required when skus is provided.","uniqueKey":"trackReference","typeLabel":"string"},"parcelWeight":{"type":"string","description":"Parcel weight in grams. Required when skus is provided.","uniqueKey":"parcelWeight","typeLabel":"string"},"brandCode":{"type":"string","description":"Your brand code as provided by OpenBorder. Required when skus is provided.","uniqueKey":"brandCode","typeLabel":"string"},"locationCode":{"type":"string","description":"An optional location code used for partial label consolidation across fulfillment centers.","uniqueKey":"locationCode","typeLabel":"string"},"zpl":{"type":"boolean","description":"When true, the response includes a URL to the label in ZPL format for thermal printers.","uniqueKey":"zpl","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"fullOrderFulfillment":{"title":"fullOrderFulfillment","value":{"orderNumber":"#12345"}},"splitShipmentFulfillment":{"title":"splitShipmentFulfillment","value":{"orderNumber":"#12345","skus":[{"skuName":"TSHIRT-L-BLK","asn":"ASN001","quantity":2}],"fromAddress":{"firstName":"Warehouse","lastName":"Team","phoneNumber":"+12125551234","line1":"123 Warehouse St","city":"New York","province":"NY","country":"US","zipcode":"10001"},"toAddress":{"firstName":"Jane","lastName":"Doe","phoneNumber":"+493012345678","line1":"Unter den Linden 1","city":"Berlin","province":"Berlin","country":"DE","zipcode":"10115"},"trackReference":"REF-12345","parcelWeight":"500","brandCode":"MYBRAND"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"95981475-402b-42e3-be47-feffc7cc0ae9":{"description":"Request processed. `result` is the label when one was found or generated.\nWhen the order can't be matched, `result` is the string\n`Unable to generate label` and `isError` is still false.\n","content":{"application/json":{"schema":{"type":"object","properties":{"isError":{"type":"boolean","description":"False when the request was processed successfully.","uniqueKey":"isError","typeLabel":"boolean"},"result":{"oneOf":[{"type":"object","description":"The label result, or the string `Unable to generate label` when the order can't be matched.","properties":{"orderNumber":{"type":"string","description":"The order number associated with the label.","uniqueKey":"result.oneOf.0.orderNumber","typeLabel":"string"},"labelUrls":{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"result.oneOf.0.labelUrls.items.[INDEX]","typeLabel":"string\u003curi>"},"description":"An array of URLs pointing to the generated label PDFs.","uniqueKey":"result.oneOf.0.labelUrls","typeLabel":"string\u003curi>[]"},"status":{"type":"string","enum":["success","pending","error"],"description":"Label generation status.","uniqueKey":"result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"trackingCode":{"type":"string","description":"Shipment tracking code. Returns an empty string if not yet available.","uniqueKey":"result.oneOf.0.trackingCode","typeLabel":"string"},"trackingUrl":{"type":"string","format":"uri","description":"Direct link to the shipment tracking page. Returns an empty string if not yet available.","uniqueKey":"result.oneOf.0.trackingUrl","typeLabel":"string\u003curi>"},"base64":{"type":"string","description":"Base64-encoded label string. Only present when base64 is true in the request.","uniqueKey":"result.oneOf.0.base64","typeLabel":"string"},"zpl":{"type":"string","format":"uri","description":"URL to the ZPL format label. Only present when zpl is true in the request.","uniqueKey":"result.oneOf.0.zpl","typeLabel":"string\u003curi>"},"shippingService":{"type":"string","description":"Name of the shipping service selected for this shipment. Only present when the service has been determined.","uniqueKey":"result.oneOf.0.shippingService","typeLabel":"string"}},"uniqueKey":"result.oneOf.0","typeLabel":"object"},{"type":"string","description":"The label result, or the string `Unable to generate label` when the order can't be matched.","example":"Unable to generate label","uniqueKey":"result.oneOf.1","typeLabel":"string"}],"uniqueKey":"result","typeLabel":"object | string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"labelReturned":{"title":"labelReturned","value":{"isError":false,"result":{"orderNumber":"#12345","labelUrls":["https://labelurl.com","https://labelurl2.com"],"status":"success","trackingCode":"123456789","trackingUrl":"https://trackingurl.com"}}},"unableToMatchOrder":{"title":"unableToMatchOrder","value":{"isError":false,"result":"Unable to generate label"}}},"exampleType":"examples"}},"exampleType":"examples"},"fb31ecca-e5dd-459a-a817-260bf645fe00":{"description":"The request body failed validation.","content":{"application/json":{"schema":{"type":"object","properties":{"isError":{"type":"boolean","description":"Always true for errors.","uniqueKey":"isError","typeLabel":"boolean"},"status":{"type":"integer","description":"The HTTP status code.","example":400,"uniqueKey":"status","typeLabel":"integer"},"name":{"type":"string","description":"The error type.","example":"InvalidRequestError","uniqueKey":"name","typeLabel":"string"},"message":{"type":"string","description":"A summary of the error.","example":"Invalid request","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"errors":{"type":"array","description":"One entry per request field that failed validation.","items":{"type":"object","properties":{"property":{"type":"string","description":"The request field that failed validation.","example":"orderNumber","uniqueKey":"data.errors.items.[INDEX].property","typeLabel":"string"},"errors":{"type":"array","description":"The validation messages for that field.","items":{"type":"string","example":"orderNumber must be a string","uniqueKey":"data.errors.items.[INDEX].errors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.errors.items.[INDEX].errors","typeLabel":"string[]"}},"uniqueKey":"data.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.errors","typeLabel":"object[]"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"isError":true,"status":400,"name":"InvalidRequestError","message":"Invalid request","data":{"errors":[{"property":"orderNumber","errors":["orderNumber must be a string"]}]}},"examples":{"Example":{"title":"Example","value":{"isError":true,"status":400,"name":"InvalidRequestError","message":"Invalid request","data":{"errors":[{"property":"orderNumber","errors":["orderNumber must be a string"]}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"9be06caf-0dc6-46b5-80c7-aaaebfac942b":{"description":"The bearer token is missing or doesn't match a client.","content":{"application/json":{"schema":{"type":"object","properties":{"isError":{"type":"boolean","description":"Always true for errors.","uniqueKey":"isError","typeLabel":"boolean"},"name":{"type":"string","description":"The error type.","example":"UnauthorizedError","uniqueKey":"name","typeLabel":"string"},"message":{"type":"string","description":"A summary of the error.","example":"No client found with API key","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"isError":true,"name":"UnauthorizedError","message":"No client found with API key"},"examples":{"Example":{"title":"Example","value":{"isError":true,"name":"UnauthorizedError","message":"No client found with API key"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"28d00a13-bad6-4f4d-a94a-5e95077837f0":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer token provided by OpenBorder.","scopes":[]}}},"servers":{"a7491433-2028-43d2-80a5-a32e33335046":{"url":"https://api.openborder.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer token provided by OpenBorder.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token provided by OpenBorder.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/shipping-labels.yaml"},"subdomain":"openborder-2b51b6dd","siteName":"OpenBorder API Documentation","title":"Get Label - OpenBorder API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T20:14:24.159Z","originalFileLocation":"api-reference/shipping-labels/get-label.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns one or more shipping labels associated with an OpenBorder order. For full-order fulfillment, provide the order number to retrieve the existing label. For split shipments, include the required SKU, parcel, and address information to generate a label for the specified items.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenBorder API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Label - OpenBorder API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one or more shipping labels associated with an OpenBorder order. For full-order fulfillment, provide the order number to retrieve the existing label. For split shipments, include the required SKU, parcel, and address information to generate a label for the specified items.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenBorder API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.openborder.com/api-reference/shipping-labels/get-label\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openborder-2b51b6dd.mintlify.site/_mintlify/api/og/v2?division=Shipping+Labels\u0026amp;title=Get+Label\u0026amp;description=Returns+one+or+more+shipping+labels+associated+with+an+OpenBorder+order.%0A%0AFor+full-order+fulfillment%2C+provide+the+order+number+to+retrieve+the%0Aexisting+label.+F\u0026amp;theme=ceaa7336a9dd6f17f8756e7f\u0026amp;signature=c88e2673de4b977f656feee97586242d936d45ede61c195aa2faab3a2b1db910\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Label - OpenBorder API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one or more shipping labels associated with an OpenBorder order. For full-order fulfillment, provide the order number to retrieve the existing label. For split shipments, include the required SKU, parcel, and address information to generate a label for the specified items.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openborder-2b51b6dd.mintlify.site/_mintlify/api/og/v2?division=Shipping+Labels\u0026amp;title=Get+Label\u0026amp;description=Returns+one+or+more+shipping+labels+associated+with+an+OpenBorder+order.%0A%0AFor+full-order+fulfillment%2C+provide+the+order+number+to+retrieve+the%0Aexisting+label.+F\u0026amp;theme=ceaa7336a9dd6f17f8756e7f\u0026amp;signature=c88e2673de4b977f656feee97586242d936d45ede61c195aa2faab3a2b1db910\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/openborder-2b51b6dd/3hdiynWgMBovETCn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenBorder API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0540f4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.openborder.com/api-reference/shipping-labels/get-label\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/shipping-labels/get-label.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.openborder.com/#organization\",\"name\":\"OpenBorder API Documentation\",\"url\":\"https://developers.openborder.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/openborder-2b51b6dd/S0NizTekLQ6ttVRZ/images/Logo-48px.png?fit=max\u0026auto=format\u0026n=S0NizTekLQ6ttVRZ\u0026q=85\u0026s=bce3b91de865573b8550ef923ea21b25\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.openborder.com#website\",\"name\":\"OpenBorder API Documentation\",\"url\":\"https://developers.openborder.com\",\"publisher\":{\"@id\":\"https://developers.openborder.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label#webpage\",\"url\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label\",\"name\":\"Get Label\",\"description\":\"Returns one or more shipping labels associated with an OpenBorder order. For full-order fulfillment, provide the order number to retrieve the existing label. For split shipments, include the required SKU, parcel, and address information to generate a label for the specified items.\",\"dateModified\":\"2026-09-30T20:14:24.159Z\",\"isPartOf\":{\"@id\":\"https://developers.openborder.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OpenBorder API Documentation\",\"item\":\"https://developers.openborder.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Label\",\"item\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label#apireference\",\"headline\":\"Get Label\",\"name\":\"Get Label\",\"description\":\"Returns one or more shipping labels associated with an OpenBorder order. For full-order fulfillment, provide the order number to retrieve the existing label. For split shipments, include the required SKU, parcel, and address information to generate a label for the specified items.\",\"url\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label\",\"mainEntityOfPage\":{\"@id\":\"https://developers.openborder.com/api-reference/shipping-labels/get-label#webpage\"},\"dateModified\":\"2026-09-30T20:14:24.159Z\",\"publisher\":{\"@id\":\"https://developers.openborder.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.openborder.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenBorder API Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenBorder API Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/shipping-labels/get-label.md","siteName":"OpenBorder API Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"code","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Shipping Labels","pages":[{"title":"Get Label","deprecated":null,"version":null,"openapi":"/api-reference/shipping-labels.yaml post /api/post/fc/labels","href":"/api-reference/shipping-labels/get-label"}]},{"group":"Landed Cost","pages":[{"title":"Calculate Landed Cost\n","description":"## What this endpoint does\nThis REST API calculates the **total landed cost** for shipping a cart of products internationally.\nIt determines **all costs your customer will pay**, including:\n\n- Duties\n- Import taxes\n- Other customs-related charges\n\nShowing a **fully landed cost upfront** gives your international customers transparency at checkout, reduces delivery surprises, and helps you offer **Delivered Duty Paid (DDP)** shipping.\n\n## When to Use This API\n- **During checkout**: Calculate the total landed cost in real-time when the user enters a shipping address.\n- **In the shopping cart**: Let shoppers see estimated import charges before they even reach checkout.\n- **Before creating a draft order**: Validate total shipping costs so your system can show an accurate final price, including duties and taxes.\n\n## Key business benefits\n- Eliminate unexpected customs charges that cause cart abandonment.\n- Enable a DDP (Delivered Duty Paid) experience: you collect duties and taxes at checkout.\n- Improve international conversion rates by being upfront about total cost.\n- Optionally guarantee the estimate: if all required fields are provided, your business can absorb the final bill.\n\n## What this gives your merchants\n- One shipment → One or more ship-from → One or more shipping rates → Multiple items\n- The system returns *duties, taxes, and fees** for each shipment and rate, so merchants can present accurate options at checkout.\n\n## How to ensure a guaranteed calculation\n- All required fields must be accurate.\n- Certain destination countries require **Province/State** and **zip code** to guarantee compliance.\n- If fields are missing, your calculation may be **non-guaranteed** and final charges could differ.\n","deprecated":null,"version":null,"openapi":"/api-reference/landed-cost.json post /v1/landed-cost","href":"/api-reference/landed-cost/calculate-landed-cost"},{"title":"Retrieve Landed Cost Calculation\n\n","deprecated":null,"version":null,"openapi":"/api-reference/landed-cost.json get /v1/landed-cost/{landedcost_request_id}","href":"/api-reference/landed-cost/retrieve-landed-cost-calculation"}]},{"group":"Orders","pages":[{"title":"Submit a new order","deprecated":null,"version":null,"openapi":"/api-reference/landed-cost.json post /v1/orders","href":"/api-reference/orders/submit-a-new-order"},{"title":"Update an order","deprecated":null,"version":null,"openapi":"/api-reference/landed-cost.json put /v1/orders","href":"/api-reference/orders/update-an-order"}]},{"group":"Label Compliance","pages":[{"title":"Label Compliance","deprecated":null,"version":null,"openapi":"/api-reference/label-compliance.yaml post /api/v1/{partnerId}/label-compliance","href":"/api-reference/label-compliance/label-compliance"}]},{"group":"Tracking","pages":[{"title":"Get tracking","deprecated":null,"version":null,"openapi":"/api-reference/tracking.json get /api/v1/tracking/{tracking_code}","href":"/api-reference/tracking/get-the-tracking-events-of-one-shipment-by-openborder-label-or-carrier-tracking-code"},{"title":"Batch tracking lookup","deprecated":null,"version":null,"openapi":"/api-reference/tracking.json post /api/v1/tracking/lookup","href":"/api-reference/tracking/get-the-tracking-events-of-several-shipments-in-one-call"},{"title":"Get API key details","deprecated":null,"version":null,"openapi":"/api-reference/tracking.json get /api/v1/me","href":"/api-reference/api-key/what-this-api-key-is-and-which-brands-it-covers"}]}]}]},"basePath":"","title":"Get Label - OpenBorder API Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C4GwDT3_.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}