Et REST-API,
du kan bygge på.
Endpoints med Bearer-nøgler og scope til returneringer, sporing, returlabels og en returagent, du spørger på almindeligt dansk, med rate limits per nøgle. Den bredere programmerbare platform ligger på roadmappen.
Prøv et kald.
Vælg et endpoint. Request og response opdateres ved siden af.
Hent en returnering
Henter én returnering som JSON. {id} tager enten returnummeret (RET-####) eller det interne id. 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 }
]
}Alle endpoints.
/api/v1/returns/{id} Hent en returnering (JSON) · returns:read live/api/v1/returns/{id}/tracking Aktuel sporingsstatus · returns:read live/api/v1/returns/{id}/label Returlabel som PDF (302-redirect) · labels:read live/api/v1/agent Returagent, du spørger på almindeligt dansk · returns:read live/api/v1/openapi.json OpenAPI 3.1-spec · public livereturn.* Signerede webhooks: created · approved · received · refunded · exchanged · cancelled liveSådan godkendes kaldene.
Bearer-nøgler
Send Authorization: Bearer ret_live_<key> på hvert /api/v1/*-kald. Nøglen vises kun én gang, når den oprettes, og vi gemmer udelukkende en hash. Opret og tilbagekald nøgler under Settings → API Keys.
Fejl
- 401 ukendt eller tilbagekaldt nøgle
- 403 nøglen mangler det scope, der kræves
- 404 ingen sådan returnering i din butik
- 429 grænsen er nået (se
Retry-After)
Hver fejl svarer med JSON { error, message, code }: error og message er den samme tekst til mennesker, code er en stabil maskinlæsbar slug
(unauthorized, forbidden, not_found, rate_limited, …) du trygt kan forgrene på.
Rate limits
120 kald i minuttet per nøgle. Hvert svar bærer X-RateLimit-Limit, X-RateLimit-Remaining, og X-RateLimit-Reset, og 429-svar lægger Retry-After.
Det, du kan bygge med.
Roadmap for integrationer.
Shopify er live i dag. Fortæl os, hvad der står for tur i din stak, så prioriterer vi det.
Byg videre med Returner.
Opret en nøgle under Settings → API Keys, og læs så specifikationen eller generér en klient.