Skip to main content
The Sendcloud Returns API lets you create standalone return labels programmatically. No need to have shipped the original parcel through Sendcloud — this API works with any return scenario.

​
What you can do

​
Returns API

Easily and efficiently create returns, even if the outgoing parcel was not shipped by Sendcloud. The Returns API endpoints support international returns and customs documentation, and gives you the ability to quickly look up which shipping method is most appropriate for your return.

Returns API

Explore the Returns API documentation and API playground

​
Key differences from our Return portal API [deprecated]

The old Return portal API required you to:
  1. Look up the original outgoing parcel
  2. Generate JWT tokens from the lookup
  3. Use those tokens to create a return
The v3 Returns API is simpler:
  • No outgoing parcel lookup required
  • Works with standard API authentication
  • Creates standalone returns from any source

​
Synchronous vs Asynchronous

We offer both a synchronous and asynchronous version of the same endpoint. Which one you should use generally depends on your data quality and performance needs. Provided your data quality is up to par using the asynchronous endpoint is what we would recommend. It is a more performant endpoint.