Skip to content

Returns

Use these endpoints to push marketplace return requests into Gierd, record per-item disposition decisions, and retrieve return data.

Pattern Endpoints
Write — submit return requests POST /ingest/returns
Write — submit per-item disposition POST /ingest/returns/{return_id}/dispositions
Read — retrieve returns GET /returns, GET /returns/{return_id}

Write endpoints are asynchronous — they return 202 Accepted immediately. Poll GET /requests/{request_id} to confirm processing.

Open the Returns endpoints in the API reference