Ett REST-API
du kan bygga på.
Endpoints med Bearer-autentisering och scope för returer, spårning, fraktsedlar och en returagent du frågar på vanlig svenska, med rate limits per nyckel. Den bredare programmerbara plattformen ligger på roadmappen.
Testa ett anrop.
Välj en endpoint. Request och response uppdateras bredvid.
Hämta en retur
Hämtar en enskild retur som JSON. {id} tar antingen returnumret (RET-####) eller det interna id:t. Kräver returns:read.
curl https://app.returner.me/api/v1/returns/RET-9284 \
-H "Authorization: Bearer $RETURNER_API_KEY"{
"return_id": "RET-9284",
"order": "#1042",
"status": "in_transit",
"type": "refund",
"created_at": "2026-03-14T09:12:00Z",
"customer": { "name": "Maria Holm", "email": "[email protected]" },
"refund": { "amount": 49.00, "currency": "EUR" },
"carrier": "postnord",
"tracking_number": "SE392847561",
"items": [
{ "sku": "TEE-BLK-L", "name": "Cotton Tee",
"quantity": 1, "reason": "too_small", "condition": null }
]
}Alla endpoints.
/api/v1/returns/{id} Hämta en retur (JSON) · returns:read live/api/v1/returns/{id}/tracking Aktuell spårningsstatus · returns:read live/api/v1/returns/{id}/label Fraktsedel som PDF (302-redirect) · labels:read live/api/v1/agent Returagent du frågar på vanlig svenska · returns:read live/api/v1/openapi.json OpenAPI 3.1-spec · public livereturn.* Signerade webhooks: created · approved · received · refunded · exchanged · cancelled liveSå auktoriseras anropen.
Bearer-nycklar
Skicka Authorization: Bearer ret_live_<key> i varje anrop mot /api/v1/*. Nyckeln visas bara en gång, när den skapas, och vi lagrar enbart en hash. Skapa och återkalla nycklar under Settings → API Keys.
Fel
- 401 okänd eller återkallad nyckel
- 403 nyckeln saknar det scope som krävs
- 404 ingen sådan retur i din butik
- 429 rate limit överskriden (se
Retry-After)
Varje fel svarar med JSON { error, message, code }: error och message är samma läsbara sträng; code är en stabil maskinläsbar slug
(unauthorized, forbidden, not_found, rate_limited, …) som du tryggt kan grena på.
Rate limits
120 anrop per minut och nyckel. Varje svar bär X-RateLimit-Limit, X-RateLimit-Remaining, och X-RateLimit-Reset; vid 429 tillkommer Retry-After.
Det här ger API:et dig.
Roadmap för integrationer.
Shopify är live i dag. Säg vilken som är viktigast för din stack, så prioriterar vi den.
Börja bygga med Returner.
Skapa en nyckel under Settings → API Keys, läs sedan specen eller generera en klient.