Sendcloud

Sendcloud Returns API

The Returns API from Sendcloud — 6 operation(s) for returns.

Documentation GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /addresses/validate Validate a shipping address · Validate an address #

Ask an LLM

“Can I check that a shipping address is valid before I create a label?”

“Which carrier do I need to name when checking an address for deliverability?”

Tell an agent

Validate the address {address} for carrier {carrier_code}.

Check whether {address} is a deliverable address before shipping with {carrier_code}.

POST /returns Create a return · Create a return #

Ask an LLM

“How do I create a standalone return for a customer?”

“Can I send tracking emails to the customer when creating a return?”

Tell an agent

Create a return from {from_address} to {to_address} weighing {weight} with {ship_with}.

Create a return for order {order_number} from {from_address}.

GET /returns List returns · Retrieve a list of returns #

Ask an LLM

“Which returns were created in the last two weeks?”

“Can I filter returns by the status of the original parcel?”

Tell an agent

List returns from {from_date} to {to_date}.

Show returns between {from_date} and {to_date} with parent status {parent_parcel_status}.

GET /returns/{id} Get a return · Retrieve a return #

Ask an LLM

“How do I check the details of a specific return?”

“What's the status of one return parcel?”

Tell an agent

Show return {id}.

Get the details of return {id}.

PATCH /returns/{id}/cancel Request cancellation of a return · Request cancellation of a return #

Ask an LLM

“Can I cancel a return a customer no longer needs?”

“How do I ask for a return to be cancelled?”

Tell an agent destructive · confirm first

Request cancellation of return {id}.

Cancel return {id}.

POST /returns/validate Check a return can be announced · Validate a return #

Ask an LLM

“Can I test whether a return would be accepted without creating it?”

“Is there a dry run for returns before announcing to the carrier?”

Tell an agent

Validate a return from {from_address} to {to_address} via {ship_with} without creating it.

Dry-run a {weight} return from {from_address}.

POST /returns/announce-synchronously Create a return and wait for the carrier · Create a return synchronously #

Ask an LLM

“How do I create a return and get the carrier's response immediately?”

“Can I announce a return synchronously instead of in the background?”

Tell an agent

Create a return synchronously from {from_address} to {to_address} with {ship_with}.

Announce a {weight} return now and wait for the carrier.

Documentation

https://sendcloud.dev/api/v3/shipments/

https://sendcloud.dev/api/v3/shipments/create-and-announce-a-shipment-synchronously

https://sendcloud.dev/api/v3/orders/

https://sendcloud.dev/api/v3/ship-an-order/

https://sendcloud.dev/api/v3/returns/

https://sendcloud.dev/api/v3/service-points/

https://sendcloud.dev/api/v3/parcel-tracking/

https://sendcloud.dev/api/v3/parcel-documents/

https://sendcloud.dev/api/v3/webhooks/

https://sendcloud.dev/api/v3/event-subscriptions/

https://sendcloud.dev/api/v3/integrations/

https://sendcloud.dev/api/v3/analytics/

https://sendcloud.dev/api/v3/reporting/

https://sendcloud.dev/api/v2/parcels/

https://sendcloud.dev/api/v2/labels/

https://sendcloud.dev/api/v2/tracking/

https://sendcloud.dev/api/v2/webhooks/

https://sendcloud.dev/api/v2/integrations/

https://sendcloud.dev/api/v2/analytics/

https://sendcloud.dev/api/v2/reporting/

https://sendcloud.dev/api/v2/parcel-documents/

Specifications

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/openapi/sendcloud-returns-api-openapi.yml

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-structure/sendcloud-shipment-structure.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-order-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-return-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-deliveryoption-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-structure/sendcloud-return-structure.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepoint-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepointdetail-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-servicepointaddress-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-parceltrackingresponse-schema.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/json-schema/sendcloud-parceltrackingcreaterequest-schema.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-announce-shipment-example.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-create-return-example.json

https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/examples/sendcloud-list-service-points-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/sendcloud:sendcloud-returns-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Sendcloud Returns API
  version: 3.0.0
  description: 'Operations tagged Returns across 2 of this provider''s published API definitions: sendcloud-shipments-openapi.yml, sendcloud-v3-returns-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://panel.sendcloud.sc/api/v3
  description: Sendcloud Production
tags:


# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sendcloud/refs/heads/main/openapi/sendcloud-returns-api-openapi.yml