Shipments are composed of a delivery and optionally a collection.
Authorizations
Authorization
string
header
required
The access token received from the authorization server in the OAuth 2.0 flow.
Body
application/json
Create return shipment request
id
string
required
carrier
object
required
Carrier details
Show child attributes
shipment
object
required
Return Shipment details
Show child attributes
sendEmail
boolean
default:false
Send customer email communications flag. Setting this to true will make At Last send any return related emails to the end user. This only impact return creation emails when using the API. This flag defaults to false.
ignore
enum<string>[]
Carrier constraints to ignore when creating a shipment. If not specified, all constraints will be checked.
While our service constraints are based on carrier specifications, like size, these specifications are often vague and difficult to enforce.
To allow for this, we provide a way to ignore specific constraints when creating a shipment.
** Note that this is not a replacement for the service constraints, it is only a way to ignore specific constraints when creating a shipment. And the API consumer is still responsible for ensuring that the shipment is valid. **
Available options:
SIZE
Response
The request has succeeded.
Return Shipment resource
id
string<uuid>
required
At last shipment id
carrier
object
required
Show child attributes
parcel
object
required
Show child attributes
from
object
required
Data used to specify address and receiver/sender details to create a shipment and collection.
The data send in these address details are NOT verified. It's the responsibility of the caller to ensure the address data is correct or shipment/collection requests can fail.
Show child attributes
to
object
required
Data used to specify address and receiver/sender details to create a shipment and collection.
The data send in these address details are NOT verified. It's the responsibility of the caller to ensure the address data is correct or shipment/collection requests can fail.
Show child attributes
state
enum<string>
required
Available options:
AWAITING_BOOKING,
READY,
ONGOING,
COMPLETE,
CANCELED,
FAIL
metadata
object
required
Show child attributes
createdAt
string<date-time>
required
hasDelivery
boolean
required
hasCollection
boolean
required
reference
string
Shipment Reference.
Required string length: 1 - 20
reference2
string
Optional shipping reference (might not be suported by all carriers)
Required string length: 1 - 20
labels
object[]
Show child attributes
trackingNumber
string
trackingUrl
string<uri>
statusDescription
string
failureReason
string
latestDeliveryEvent
enum<string>
Available options:
BOOKED,
COLLECTED,
AT_HUB,
IN_TRANSIT,
OUT_FOR_DELIVERY,
FAILED_ATTEMPT,
DELIVERED,
ON_HOLD,
ADDRESS_ISSUE,
RETURNED_TO_SENDER,
TRACKING_EXPIRED,
CANCELLED,
AWAITING_CUSTOMER_COLLECTION,
PACKING,
MISSING,
DAMAGED
deliveryState
enum<string>
Available options:
AWAITING_BOOKING,
READY,
ONGOING,
COMPLETE,
CANCELED,
FAIL
collectionRequestedTimeSlot
object
Resovled collection time slot
Show child attributes
collection
object
Show child attributes
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"At Last Docs","colors":{"primary":"#6B6DED","light":"#D9D4F6","dark":"#6B6DED"},"favicon":"https://mintcdn.com/fastrefundco/hdH4rJbLqfelLEhs/favicon.svg?fit=max\u0026auto=format\u0026n=hdH4rJbLqfelLEhs\u0026q=85\u0026s=f4e56c7cd12c86a4ac71492983eb9500","logo":{"light":"https://mintcdn.com/fastrefundco/hdH4rJbLqfelLEhs/logo/light.svg?fit=max\u0026auto=format\u0026n=hdH4rJbLqfelLEhs\u0026q=85\u0026s=b1567d74c64553477c802513834b9afd","dark":"https://mintcdn.com/fastrefundco/hdH4rJbLqfelLEhs/logo/dark.svg?fit=max\u0026auto=format\u0026n=hdH4rJbLqfelLEhs\u0026q=85\u0026s=9c9ef2d6329998d27bdf9dca96e2a16a"},"api":{"openapi":"https://cdn.atlast.co/spec/api.v1.json"},"background":{"decoration":null,"color":{"light":"#F6F6F6","dark":"#172027"}},"navbar":{"links":[{"label":"Support","href":"mailto:support@atlast.co"},{"label":"Api Spec","href":"https://cdn.atlast.co/spec/api.v1.json"}],"primary":{"type":"button","label":"Dashboard","href":"https://business.atlast.co"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fastrefundco","hasAudioNarration":false,"actualSubdomain":"fastrefundco","customDomains":["docs.atlast.co"],"gitSource":{"type":"github","owner":"fast-refund","repo":"public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae920ccfb1d10c3791d043c:success","clientVersion":"0.0.4128","searchFilterCounts":[{"language":"default","tag":"API Reference","count":14},{"language":"default","tag":"Endpoints","count":8},{"language":"default","tag":"Webhooks","count":4},{"language":"default","tag":"Reference","count":3},{"language":"default","tag":"API Documentation","count":2},{"language":"default","tag":"Carriers","count":2},{"language":"default","tag":"Collections","count":2},{"language":"default","tag":"Shipments","count":2},{"language":"default","tag":"Auth","count":1},{"language":"default","tag":"Orders","count":1}]},"assistantConfig":{},"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":"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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoints/post-shipments-returns","slug":"/api-reference/endpoints/post-shipments-returns","pageMetadata":{"openapi":"post /shipments/returns","title":"Create a returns shipment","sidebarTitle":"Create Return Shipment","description":"Create a shipment","href":"/api-reference/endpoints/post-shipments-returns"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a shipment\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Shipments are composed of a delivery and optionally a collection.`})}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":{"config":{},"pageMetadata":{"openapi":"post /shipments/returns","title":"Create a returns shipment","sidebarTitle":"Create Return Shipment","description":"Create a shipment","href":"/api-reference/endpoints/post-shipments-returns"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"Shipments_createReturnsShipment","description":"Create a shipment","parameters":[],"responses":{"200":"0af80180-9946-4f82-b180-f20e357b639a","401":"b9f1daea-4b5c-4fd1-b1e8-9ad9bb6f777d","403":"3ff83f53-58b3-4272-9fe5-3b61251a85aa","404":"2d47f418-ad8c-4b6b-abe4-3421245fef98","500":"6db0d8a6-5954-4267-897b-d0c2d54b611d"},"requestBody":"03598eb7-bdd2-40d8-8dfa-9d3c785d020c","security":["8f7b35e4-5d64-423f-ae3a-406ac2c51efd"],"method":"post","type":"path","servers":["5a4a1e77-1bcc-495b-883a-d5104d57f0c7"],"path":"/shipments/returns","baseUrlOptions":["https://api.atlast.co/v1"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","carrier","shipment"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"carrier":{"type":"object","description":"Carrier details","required":["id","serviceId"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"carrier.id","typeLabel":"string\u003cuuid>"},"serviceId":{"type":"string","isRequired":true,"uniqueKey":"carrier.serviceId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"carrier","typeLabel":"object"},"shipment":{"type":"object","description":"Return Shipment details","required":["from","return"],"properties":{"from":{"type":"object","description":"Address information for the person that will be sending the shipment","required":["name","email","address"],"properties":{"name":{"type":"string","description":"The last name of the person sending or receiving the parcel.\nThis is the minimum we need to create a shipment/collection.","isRequired":true,"uniqueKey":"shipment.from.name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"The email of the person sending or receiving the parcel.\nThis is used for communication any communication with the user.\nThis might be sent to carriers as well for them to manage their own communication with the user (notably for home collection updates)","isRequired":true,"uniqueKey":"shipment.from.email","typeLabel":"string\u003cemail>"},"address":{"type":"object","description":"The shipping address detail","required":["line1","city","postCode"],"properties":{"line1":{"type":"string","maxLength":40,"description":"Line 1 of the address.","isRequired":true,"uniqueKey":"shipment.from.address.line1","typeLabel":"string"},"city":{"type":"string","description":"Address city.","isRequired":true,"uniqueKey":"shipment.from.address.city","typeLabel":"string"},"postCode":{"type":"string","minLength":4,"description":"Address postcode. Needs to be a valid UK postcode.","isRequired":true,"uniqueKey":"shipment.from.address.postCode","typeLabel":"string"},"line2":{"type":"string","maxLength":40,"description":"Line 2 of the address (optional).","uniqueKey":"shipment.from.address.line2","typeLabel":"string"},"line3":{"type":"string","maxLength":40,"description":"Line 3 of the address (optional).","uniqueKey":"shipment.from.address.line3","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the address. Optional; defaults to `GB`\nwhen omitted. Required in practice for international (cross-border) returns\nso the sender's origin country is declared correctly to customs.\n**MANDATORY when creating cross border shipments**","uniqueKey":"shipment.from.address.country","typeLabel":"string"},"province":{"type":"string","description":"State / province name of the address (e.g. \"California\"). Optional. Used as\nthe address state for international returns to countries that require it\n(e.g. US, CA, AU).\n**MANDATORY when creating cross border shipments**","uniqueKey":"shipment.from.address.province","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipment.from.address","typeLabel":"object"},"phoneNumber":{"type":"string","description":"The phone number of the person sending or receiving the parcel.\nThis can be sent to carriers for them to manage their own communication with the user.","uniqueKey":"shipment.from.phoneNumber","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipment.from","typeLabel":"object"},"return":{"type":"object","description":"Return specific details","required":["dimensions","orderIdentifier","items"],"properties":{"dimensions":{"type":"object","description":"Dimensions of the physical package","required":["width","height","length","unit"],"properties":{"width":{"type":"number","description":"Expected length of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"shipment.return.dimensions.width","typeLabel":"number"},"height":{"type":"number","description":"Expected height of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"shipment.return.dimensions.height","typeLabel":"number"},"length":{"type":"number","description":"Expected length of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"shipment.return.dimensions.length","typeLabel":"number"},"unit":{"type":"string","description":"The unit of measure used for all the dimension values in the parcel","enum":["CM"],"isRequired":true,"uniqueKey":"shipment.return.dimensions.unit","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"shipment.return.dimensions","typeLabel":"object"},"orderIdentifier":{"type":"string","minLength":1,"description":"Identifier for the original order (like for example the order number)","isRequired":true,"uniqueKey":"shipment.return.orderIdentifier","typeLabel":"string"},"items":{"type":"array","items":{"type":"object","required":["quantity","value","weight","reason"],"properties":{"quantity":{"type":"integer","minimum":1,"description":"How many of the same item are being returned","isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].quantity","typeLabel":"integer"},"value":{"type":"object","description":"How much is a single item worth","required":["value","currency"],"properties":{"value":{"type":"number","minimum":0,"description":"Specifies the value price instance, price values can be floats.\n**Min Value: 0**","isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].value.value","typeLabel":"number"},"currency":{"type":"string","description":"ISO 4217 currency codes","isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].value.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].value","typeLabel":"object"},"weight":{"type":"object","description":"How much does a single item weigh","required":["value","unit"],"properties":{"value":{"type":"number","description":"Specifies the value of the weight, weights values can be floats.\n**Min Value: 0 non inclusive**","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].weight.value","typeLabel":"number"},"unit":{"type":"string","description":"The unit of the value as seen in WeightUnits enum.","enum":["GRAMS","KILOGRAMS","OUNCES","POUNDS"],"isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].weight.unit","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].weight","typeLabel":"object"},"reason":{"type":"string","description":"Reason why the item is being returned","enum":["TOO_LARGE","TOO_SMALL","DIFFERENT_IMAGE","DIFFERENT_DESCRIPTION","POOR_QUALITY","TOO_EXPENSIVE","CHANGED_MIND","ARRIVED_LATE","ACCIDENTAL_PURCHASE","DAMAGED","INCORRECT_ITEM","OTHER","RECYCLE","REPAIR_OR_REPLACEMENT"],"isRequired":true,"uniqueKey":"shipment.return.\\items.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"hsCode":{"type":"string","description":"Harmonised System (HS) tariff code for the item. Required for\ninternational (cross-border) returns; used for the customs declaration.\n**MANDATORY when creating cross border shipments**","uniqueKey":"shipment.return.\\items.items.[INDEX].hsCode","typeLabel":"string"},"countryCodeOfOrigin":{"type":"string","description":"ISO 3166-1 alpha-2 country code where the item was manufactured.\nRequired for international (cross-border) returns; used for customs.\n**MANDATORY when creating cross border shipments**","uniqueKey":"shipment.return.\\items.items.[INDEX].countryCodeOfOrigin","typeLabel":"string"}},"description":"Describe the items being returned.\nThe carrier service used will make certain fields mandatory, those will be flagged in the docs.","uniqueKey":"shipment.return.\\items.items.[INDEX]","typeLabel":"object"},"minItems":1,"description":"The item information in the shipment","isRequired":true,"uniqueKey":"shipment.return.\\items","typeLabel":"object[]"},"fulfilment":{"type":"object","description":"Outbound fulfilment information\n**MANDATORY when creating cross border shipments**","required":["carrier","trackingNumber","exportDate"],"properties":{"carrier":{"type":"string","description":"Name of the carrier that delivered the original order.","isRequired":true,"uniqueKey":"shipment.return.fulfilment.carrier","typeLabel":"string"},"trackingNumber":{"type":"string","description":"Tracking number of the original outbound shipment.","isRequired":true,"uniqueKey":"shipment.return.fulfilment.trackingNumber","typeLabel":"string"},"exportDate":{"type":"string","description":"Date the original order was shipped (ISO-8601).","isRequired":true,"uniqueKey":"shipment.return.fulfilment.exportDate","typeLabel":"string"}},"uniqueKey":"shipment.return.fulfilment","typeLabel":"object"}},"isRequired":true,"uniqueKey":"shipment.return","typeLabel":"object"},"reference":{"type":"string","maxLength":20,"description":"Shipment Reference.\n**Max Length: 20**","uniqueKey":"shipment.reference","typeLabel":"string"},"reference2":{"type":"string","maxLength":20,"description":"Optional shipping reference (might not be suported by all carriers)\n**Max Length: 20**","uniqueKey":"shipment.reference2","typeLabel":"string"}},"isRequired":true,"uniqueKey":"shipment","typeLabel":"object"},"sendEmail":{"type":"boolean","description":"Send customer email communications flag. Setting this to true will make At Last send any return related emails to the end user. This only impact return creation emails when using the API. This flag defaults to false.","default":false,"uniqueKey":"sendEmail","typeLabel":"boolean"},"ignore":{"type":"array","items":{"type":"string","enum":["SIZE"],"description":"Carrier constraints to ignore when creating a shipment. If not specified, all constraints will be checked.\nWhile our service constraints are based on carrier specifications, like size, these specifications are often vague and difficult to enforce.\nTo allow for this, we provide a way to ignore specific constraints when creating a shipment.\n** Note that this is not a replacement for the service constraints, it is only a way to ignore specific constraints when creating a shipment. And the API consumer is still responsible for ensuring that the shipment is valid. **","uniqueKey":"ignore.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"ignore","typeLabel":"enum\u003cstring>[]"}},"description":"Create return shipment request","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","carrier":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","serviceId":"\u003cstring>"},"shipment":{"from":{"name":"\u003cstring>","email":"jsmith@example.com","address":{"line1":"\u003cstring>","city":"\u003cstring>","postCode":"\u003cstring>","line2":"\u003cstring>","line3":"\u003cstring>","country":"\u003cstring>","province":"\u003cstring>"},"phoneNumber":"\u003cstring>"},"return":{"dimensions":{"width":1,"height":1,"length":1,"unit":"CM"},"orderIdentifier":"\u003cstring>","items":[{"quantity":2,"value":{"value":1,"currency":"\u003cstring>"},"weight":{"value":1},"hsCode":"\u003cstring>","countryCodeOfOrigin":"\u003cstring>"}]},"reference":"\u003cstring>","reference2":"\u003cstring>"},"sendEmail":false,"ignore":["SIZE"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0af80180-9946-4f82-b180-f20e357b639a":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"type":"object","required":["id","carrier","parcel","from","to","state","metadata","createdAt","hasDelivery","hasCollection"],"properties":{"id":{"type":"string","format":"uuid","description":"At last shipment id","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"carrier":{"type":"object","required":["id","serviceId"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"carrier.id","typeLabel":"string\u003cuuid>"},"serviceId":{"type":"string","isRequired":true,"uniqueKey":"carrier.serviceId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"carrier","typeLabel":"object"},"parcel":{"type":"object","required":["dimensions","weight","items"],"properties":{"dimensions":{"type":"object","required":["width","height","length","unit"],"properties":{"width":{"type":"number","description":"Expected length of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"parcel.dimensions.width","typeLabel":"number"},"height":{"type":"number","description":"Expected height of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"parcel.dimensions.height","typeLabel":"number"},"length":{"type":"number","description":"Expected length of the shipment package in the unit of measure specified in the unit field","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"parcel.dimensions.length","typeLabel":"number"},"unit":{"type":"string","description":"The unit of measure used for all the dimension values in the parcel","enum":["CM"],"isRequired":true,"uniqueKey":"parcel.dimensions.unit","typeLabel":"enum\u003cstring>"}},"description":"The details for the parcel that you wish to create. Dimensions and items, together with their weights, need to be specified in order for us to create a shipment","isRequired":true,"uniqueKey":"parcel.dimensions","typeLabel":"object"},"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number","description":"Specifies the value of the weight, weights values can be floats.\n**Min Value: 0 non inclusive**","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"parcel.weight.value","typeLabel":"number"},"unit":{"type":"string","description":"The unit of the value as seen in WeightUnits enum.","enum":["GRAMS","KILOGRAMS","OUNCES","POUNDS"],"isRequired":true,"uniqueKey":"parcel.weight.unit","typeLabel":"enum\u003cstring>"}},"description":"Weight model used to define weights","isRequired":true,"uniqueKey":"parcel.weight","typeLabel":"object"},"items":{"type":"array","items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"parcel.\\items.items.[INDEX].quantity","typeLabel":"integer"},"description":{"type":"string","uniqueKey":"parcel.\\items.items.[INDEX].description","typeLabel":"string"},"value":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"number","minimum":0,"description":"Specifies the value price instance, price values can be floats.\n**Min Value: 0**","isRequired":true,"uniqueKey":"parcel.\\items.items.[INDEX].value.value","typeLabel":"number"},"currency":{"type":"string","description":"ISO 4217 currency codes","isRequired":true,"uniqueKey":"parcel.\\items.items.[INDEX].value.currency","typeLabel":"string"}},"description":"Price model used to define any currency exchange or value.","uniqueKey":"parcel.\\items.items.[INDEX].value","typeLabel":"object"},"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number","description":"Specifies the value of the weight, weights values can be floats.\n**Min Value: 0 non inclusive**","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"parcel.\\items.items.[INDEX].weight.value","typeLabel":"number"},"unit":{"type":"string","description":"The unit of the value as seen in WeightUnits enum.","enum":["GRAMS","KILOGRAMS","OUNCES","POUNDS"],"isRequired":true,"uniqueKey":"parcel.\\items.items.[INDEX].weight.unit","typeLabel":"enum\u003cstring>"}},"description":"Weight model used to define weights","uniqueKey":"parcel.\\items.items.[INDEX].weight","typeLabel":"object"}},"required":["quantity"],"uniqueKey":"parcel.\\items.items.[INDEX]","typeLabel":"object"},"minItems":1,"isRequired":true,"uniqueKey":"parcel.\\items","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"parcel","typeLabel":"object"},"from":{"type":"object","required":["name","email","address"],"properties":{"name":{"type":"string","description":"The last name of the person sending or receiving the parcel.\nThis is the minimum we need to create a shipment/collection.","isRequired":true,"uniqueKey":"from.name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"The email of the person sending or receiving the parcel.\nThis is used for communication any communication with the user.\nThis might be sent to carriers as well for them to manage their own communication with the user (notably for home collection updates)","isRequired":true,"uniqueKey":"from.email","typeLabel":"string\u003cemail>"},"address":{"type":"object","description":"The shipping address detail","required":["line1","city","postCode"],"properties":{"line1":{"type":"string","maxLength":40,"description":"Line 1 of the address.","isRequired":true,"uniqueKey":"from.address.line1","typeLabel":"string"},"city":{"type":"string","description":"Address city.","isRequired":true,"uniqueKey":"from.address.city","typeLabel":"string"},"postCode":{"type":"string","minLength":4,"description":"Address postcode. Needs to be a valid UK postcode.","isRequired":true,"uniqueKey":"from.address.postCode","typeLabel":"string"},"line2":{"type":"string","maxLength":40,"description":"Line 2 of the address (optional).","uniqueKey":"from.address.line2","typeLabel":"string"},"line3":{"type":"string","maxLength":40,"description":"Line 3 of the address (optional).","uniqueKey":"from.address.line3","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the address. Optional; defaults to `GB`\nwhen omitted. Required in practice for international (cross-border) returns\nso the sender's origin country is declared correctly to customs.\n**MANDATORY when creating cross border shipments**","uniqueKey":"from.address.country","typeLabel":"string"},"province":{"type":"string","description":"State / province name of the address (e.g. \"California\"). Optional. Used as\nthe address state for international returns to countries that require it\n(e.g. US, CA, AU).\n**MANDATORY when creating cross border shipments**","uniqueKey":"from.address.province","typeLabel":"string"}},"isRequired":true,"uniqueKey":"from.address","typeLabel":"object"},"phoneNumber":{"type":"string","description":"The phone number of the person sending or receiving the parcel.\nThis can be sent to carriers for them to manage their own communication with the user.","uniqueKey":"from.phoneNumber","typeLabel":"string"}},"description":"Data used to specify address and receiver/sender details to create a shipment and collection.\nThe data send in these address details are NOT verified. It's the responsibility of the caller to ensure the address data is correct or shipment/collection requests can fail.","isRequired":true,"uniqueKey":"from","typeLabel":"object"},"to":{"type":"object","required":["name","email","address"],"properties":{"name":{"type":"string","description":"The last name of the person sending or receiving the parcel.\nThis is the minimum we need to create a shipment/collection.","isRequired":true,"uniqueKey":"to.name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"The email of the person sending or receiving the parcel.\nThis is used for communication any communication with the user.\nThis might be sent to carriers as well for them to manage their own communication with the user (notably for home collection updates)","isRequired":true,"uniqueKey":"to.email","typeLabel":"string\u003cemail>"},"address":{"type":"object","description":"The shipping address detail","required":["line1","city","postCode"],"properties":{"line1":{"type":"string","maxLength":40,"description":"Line 1 of the address.","isRequired":true,"uniqueKey":"to.address.line1","typeLabel":"string"},"city":{"type":"string","description":"Address city.","isRequired":true,"uniqueKey":"to.address.city","typeLabel":"string"},"postCode":{"type":"string","minLength":4,"description":"Address postcode. Needs to be a valid UK postcode.","isRequired":true,"uniqueKey":"to.address.postCode","typeLabel":"string"},"line2":{"type":"string","maxLength":40,"description":"Line 2 of the address (optional).","uniqueKey":"to.address.line2","typeLabel":"string"},"line3":{"type":"string","maxLength":40,"description":"Line 3 of the address (optional).","uniqueKey":"to.address.line3","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the address. Optional; defaults to `GB`\nwhen omitted. Required in practice for international (cross-border) returns\nso the sender's origin country is declared correctly to customs.\n**MANDATORY when creating cross border shipments**","uniqueKey":"to.address.country","typeLabel":"string"},"province":{"type":"string","description":"State / province name of the address (e.g. \"California\"). Optional. Used as\nthe address state for international returns to countries that require it\n(e.g. US, CA, AU).\n**MANDATORY when creating cross border shipments**","uniqueKey":"to.address.province","typeLabel":"string"}},"isRequired":true,"uniqueKey":"to.address","typeLabel":"object"},"phoneNumber":{"type":"string","description":"The phone number of the person sending or receiving the parcel.\nThis can be sent to carriers for them to manage their own communication with the user.","uniqueKey":"to.phoneNumber","typeLabel":"string"}},"description":"Data used to specify address and receiver/sender details to create a shipment and collection.\nThe data send in these address details are NOT verified. It's the responsibility of the caller to ensure the address data is correct or shipment/collection requests can fail.","isRequired":true,"uniqueKey":"to","typeLabel":"object"},"state":{"type":"string","enum":["AWAITING_BOOKING","READY","ONGOING","COMPLETE","CANCELED","FAIL"],"isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","required":["returnId","merchant","user","items"],"properties":{"returnId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"metadata.returnId","typeLabel":"string\u003cuuid>"},"merchant":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"metadata.merchant.id","typeLabel":"string"}},"required":["id"],"isRequired":true,"uniqueKey":"metadata.merchant","typeLabel":"object"},"user":{"type":"object","properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"metadata.user.email","typeLabel":"string\u003cemail>"}},"required":["email"],"isRequired":true,"uniqueKey":"metadata.user","typeLabel":"object"},"items":{"type":"array","items":{"type":"object","required":["itemId","reason","quantity"],"properties":{"itemId":{"type":"string","isRequired":true,"uniqueKey":"metadata.\\items.items.[INDEX].itemId","typeLabel":"string"},"reason":{"type":"string","enum":["TOO_LARGE","TOO_SMALL","DIFFERENT_IMAGE","DIFFERENT_DESCRIPTION","POOR_QUALITY","TOO_EXPENSIVE","CHANGED_MIND","ARRIVED_LATE","ACCIDENTAL_PURCHASE","DAMAGED","INCORRECT_ITEM","OTHER","RECYCLE","REPAIR_OR_REPLACEMENT"],"description":"Supported returns reasons","isRequired":true,"uniqueKey":"metadata.\\items.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"quantity":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"metadata.\\items.items.[INDEX].quantity","typeLabel":"integer"}},"uniqueKey":"metadata.\\items.items.[INDEX]","typeLabel":"object"},"minItems":1,"isRequired":true,"uniqueKey":"metadata.\\items","typeLabel":"object[]"},"externalId":{"type":"string","uniqueKey":"metadata.externalId","typeLabel":"string"}},"isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"hasDelivery":{"type":"boolean","isRequired":true,"uniqueKey":"hasDelivery","typeLabel":"boolean"},"hasCollection":{"type":"boolean","isRequired":true,"uniqueKey":"hasCollection","typeLabel":"boolean"},"reference":{"type":"string","minLength":1,"maxLength":20,"description":"Shipment Reference.","uniqueKey":"reference","typeLabel":"string"},"reference2":{"type":"string","minLength":1,"maxLength":20,"description":"Optional shipping reference (might not be suported by all carriers)","uniqueKey":"reference2","typeLabel":"string"},"labels":{"type":"array","items":{"type":"object","required":["url","type"],"properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"labels.items.[INDEX].url","typeLabel":"string\u003curi>"},"type":{"type":"string","enum":["PAPERLESS","PAPER"],"isRequired":true,"uniqueKey":"labels.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"labels","typeLabel":"object[]"},"trackingNumber":{"type":"string","uniqueKey":"trackingNumber","typeLabel":"string"},"trackingUrl":{"type":"string","format":"uri","uniqueKey":"trackingUrl","typeLabel":"string\u003curi>"},"statusDescription":{"type":"string","uniqueKey":"statusDescription","typeLabel":"string"},"failureReason":{"type":"string","uniqueKey":"failureReason","typeLabel":"string"},"latestDeliveryEvent":{"type":"string","enum":["BOOKED","COLLECTED","AT_HUB","IN_TRANSIT","OUT_FOR_DELIVERY","FAILED_ATTEMPT","DELIVERED","ON_HOLD","ADDRESS_ISSUE","RETURNED_TO_SENDER","TRACKING_EXPIRED","CANCELLED","AWAITING_CUSTOMER_COLLECTION","PACKING","MISSING","DAMAGED"],"uniqueKey":"latestDeliveryEvent","typeLabel":"enum\u003cstring>"},"deliveryState":{"type":"string","enum":["AWAITING_BOOKING","READY","ONGOING","COMPLETE","CANCELED","FAIL"],"uniqueKey":"deliveryState","typeLabel":"enum\u003cstring>"},"collectionRequestedTimeSlot":{"type":"object","required":["date"],"properties":{"date":{"type":"string","description":"The time slot date, in the format YYYY-MM-DD.","isRequired":true,"uniqueKey":"collectionRequestedTimeSlot.date","typeLabel":"string"},"time":{"type":"string","description":"An optional time string, can be exact or a time range, will be carrier dependent.","uniqueKey":"collectionRequestedTimeSlot.time","typeLabel":"string"}},"description":"Resovled collection time slot","uniqueKey":"collectionRequestedTimeSlot","typeLabel":"object"},"collection":{"type":"object","required":["bookedTimeSlot","rebooked"],"properties":{"bookedTimeSlot":{"type":"object","required":["date"],"properties":{"date":{"type":"string","description":"The time slot date, in the format YYYY-MM-DD.","isRequired":true,"uniqueKey":"collection.bookedTimeSlot.date","typeLabel":"string"},"time":{"type":"string","description":"An optional time string, can be exact or a time range, will be carrier dependent.","uniqueKey":"collection.bookedTimeSlot.time","typeLabel":"string"}},"description":"Resovled collection time slot","isRequired":true,"uniqueKey":"collection.bookedTimeSlot","typeLabel":"object"},"rebooked":{"type":"boolean","isRequired":true,"uniqueKey":"collection.rebooked","typeLabel":"boolean"}},"uniqueKey":"collection","typeLabel":"object"}},"description":"Return Shipment resource","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","carrier":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","serviceId":"\u003cstring>"},"parcel":{"dimensions":{"width":1,"height":1,"length":1,"unit":"CM"},"weight":{"value":1,"unit":"GRAMS"},"items":[{"quantity":2,"description":"\u003cstring>","value":{"value":1,"currency":"\u003cstring>"},"weight":{"value":1,"unit":"GRAMS"}}]},"from":{"name":"\u003cstring>","email":"jsmith@example.com","address":{"line1":"\u003cstring>","city":"\u003cstring>","postCode":"\u003cstring>","line2":"\u003cstring>","line3":"\u003cstring>","country":"\u003cstring>","province":"\u003cstring>"},"phoneNumber":"\u003cstring>"},"to":{"name":"\u003cstring>","email":"jsmith@example.com","address":{"line1":"\u003cstring>","city":"\u003cstring>","postCode":"\u003cstring>","line2":"\u003cstring>","line3":"\u003cstring>","country":"\u003cstring>","province":"\u003cstring>"},"phoneNumber":"\u003cstring>"},"state":"AWAITING_BOOKING","metadata":{"returnId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","merchant":{"id":"\u003cstring>"},"user":{"email":"jsmith@example.com"},"items":[{"itemId":"\u003cstring>","reason":"TOO_LARGE","quantity":2}],"externalId":"\u003cstring>"},"createdAt":"2023-11-07T05:31:56Z","hasDelivery":true,"hasCollection":true,"reference":"\u003cstring>","reference2":"\u003cstring>","labels":[{"url":"\u003cstring>","type":"PAPERLESS"}],"trackingNumber":"\u003cstring>","trackingUrl":"\u003cstring>","statusDescription":"\u003cstring>","failureReason":"\u003cstring>","latestDeliveryEvent":"BOOKED","deliveryState":"AWAITING_BOOKING","collectionRequestedTimeSlot":{"date":"\u003cstring>","time":"\u003cstring>"},"collection":{"bookedTimeSlot":{"date":"\u003cstring>","time":"\u003cstring>"},"rebooked":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"b9f1daea-4b5c-4fd1-b1e8-9ad9bb6f777d":{"description":"Access is unauthorized.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"3ff83f53-58b3-4272-9fe5-3b61251a85aa":{"description":"Access is forbidden.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"2d47f418-ad8c-4b6b-abe4-3421245fef98":{"description":"The server cannot find the requested resource.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"6db0d8a6-5954-4267-897b-d0c2d54b611d":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"8f7b35e4-5d64-423f-ae3a-406ac2c51efd":{"OAuth2Auth":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.atlast.co/oauth2/token","scopes":{}}},"scopes":[]}}},"servers":{"5a4a1e77-1bcc-495b-883a-d5104d57f0c7":{"url":"https://api.atlast.co/v1","description":"Production","variables":{}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.atlast.co/oauth2/token","scopes":{}}},"scopes":[]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"OAuth2Auth","name":"Authorization"}],"title":"OAuth2Auth"}]},"originalFileLocation":"https://cdn.atlast.co/spec/api.v1.json"},"subdomain":"fastrefundco","siteName":"At Last Docs","title":"Create a returns shipment - At Last Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T02:45:20.510Z","originalFileLocation":"api-reference/endpoints/post-shipments-returns.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"system\"}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=\"Create a shipment\">\u003cmeta data-mint-head name=\"application-name\" content=\"At Last Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_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/fastrefundco/VEjJisfC0OHPyDEN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a returns shipment - At Last Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a shipment\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"At Last Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fastrefundco.mintlify.site/_mintlify/api/og/v2?division=Shipments\u0026amp;title=Create+a+returns+shipment\u0026amp;description=Create+a+shipment\u0026amp;theme=411232e26e50f87549df0a8b\u0026amp;signature=c1bbb67a943df09b1f7778430024ea02f429aa2e1703278d4cf051d8460fe30c\">\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=\"Create a returns shipment - At Last Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a shipment\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fastrefundco.mintlify.site/_mintlify/api/og/v2?division=Shipments\u0026amp;title=Create+a+returns+shipment\u0026amp;description=Create+a+shipment\u0026amp;theme=411232e26e50f87549df0a8b\u0026amp;signature=c1bbb67a943df09b1f7778430024ea02f429aa2e1703278d4cf051d8460fe30c\">\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/fastrefundco/VEjJisfC0OHPyDEN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"At Last Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6B6DED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/post-shipments-returns.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.atlast.co/#organization\",\"name\":\"At Last Docs\",\"url\":\"https://docs.atlast.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fastrefundco/hdH4rJbLqfelLEhs/logo/light.svg?fit=max\u0026auto=format\u0026n=hdH4rJbLqfelLEhs\u0026q=85\u0026s=b1567d74c64553477c802513834b9afd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.atlast.co#website\",\"name\":\"At Last Docs\",\"url\":\"https://docs.atlast.co\",\"publisher\":{\"@id\":\"https://docs.atlast.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns#webpage\",\"url\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns\",\"name\":\"Create a returns shipment\",\"description\":\"Create a shipment\",\"dateModified\":\"2026-01-07T02:45:20.510Z\",\"isPartOf\":{\"@id\":\"https://docs.atlast.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.atlast.co/api-reference/endpoints/post-authtoken\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Shipments\",\"item\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-simple\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a returns shipment\",\"item\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns#apireference\",\"headline\":\"Create a returns shipment\",\"name\":\"Create a returns shipment\",\"description\":\"Create a shipment\",\"url\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns\",\"mainEntityOfPage\":{\"@id\":\"https://docs.atlast.co/api-reference/endpoints/post-shipments-returns#webpage\"},\"dateModified\":\"2026-01-07T02:45:20.510Z\",\"publisher\":{\"@id\":\"https://docs.atlast.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.atlast.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"At Last Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"At Last Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoints/post-shipments-returns.md","siteName":"At Last Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Endpoints","pages":[{"group":"Auth","pages":[{"openapi":"post /auth/token","sidebarTitle":"Create Token","title":"Create Token","href":"/api-reference/endpoints/post-authtoken"}]},{"group":"Carriers","pages":[{"openapi":"get /carriers/services","title":"List carriers services configured to your account","sidebarTitle":"List Services","href":"/api-reference/endpoints/get-carriers"},{"openapi":"get /carriers/dropoffs","title":"Get Carrier Dropoffs","href":"/api-reference/endpoints/get-carrier-pudo"}]},{"group":"Orders","pages":[{"openapi":"post /orders/bulk","title":"Bulk create orders","href":"/api-reference/endpoints/post-orders"}]},{"group":"Collections","pages":[{"openapi":"post /collections","sidebarTitle":"Create Collection","title":"Create shipment collection","href":"/api-reference/endpoints/post-collections"},{"openapi":"put /collections/cancel","sidebarTitle":"Cancel Collection","title":"Cancel a shipment collection","href":"/api-reference/endpoints/put-collections-cancel"}]},{"group":"Shipments","pages":[{"openapi":"post /shipments/simple","title":"Create a simple shipment","sidebarTitle":"Create Simple Shipment","description":"Create a shipment","href":"/api-reference/endpoints/post-shipments-simple"},{"openapi":"post /shipments/returns","title":"Create a returns shipment","sidebarTitle":"Create Return Shipment","href":"/api-reference/endpoints/post-shipments-returns"}]}]},{"group":"Webhooks","pages":[{"title":"Introduction","description":"Webhook introduction","href":"/api-reference/webhooks/introduction"},{"group":"Reference","pages":[{"title":"Evaluation complete webhook event","sidebarTitle":"Evaluation Complete","href":"/api-reference/webhooks/return-evaluation-complete"},{"title":"Return created webhook event","sidebarTitle":"Return Created","href":"/api-reference/webhooks/return-created"},{"title":"Shipment updated and tracking webhook event","sidebarTitle":"Shipment Updated","href":"/api-reference/webhooks/shipment-updated"}]}]}]}]},"basePath":"","title":"Create a returns shipment - At Last Docs","buildId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","deploymentId":"dpl_5tKr6cUUeuVJdEZ9JAEY3h4soMJ8","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DbeN8Wo6.js","utils-CwSb5Doc.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BmREeM3N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-AYjWerCj.js","snippetPresets-QD4ULQlp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Digj5cjF.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CiHrzluR.js","shallow-D7h7pFGg.js","getApiPlaygroundDisplay-mlxkpAUf.js","CodeSnippet-D2rH5lZI.js","CodeSnippets-B53ulOaL.js","Page-CqcDm2To.js","getPastedJson-DxGeNMih.js","icon-BHbyrebp.js","MethodPill-C7F_KEEJ.js","DuplicateIcon-j3c5-73z.js","createIcon-OvCnyFqD.js","DynamicMarkdown-DpAS3GCb.js","SectionHeading-DMPpdrvW.js","axios-vUo_bRtp.js","Markdown-D7pDRguu.js","clsx-2_c6mSt_.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cu7_SikL.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ydqCcy4b.js"]}