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.