curl --request GET \
--url 'https://api.stateset.com/api/v1/returns' \
--header "Authorization: Bearer $STATESET_API_KEY"
{
"has_more": true,
"limit": 20,
"next_cursor": "string",
"offset": 1,
"returns": [
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"refund_amount": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
],
"total": 102
}
List returns
List of returns
GET
/
api
/
v1
/
returns
curl --request GET \
--url 'https://api.stateset.com/api/v1/returns' \
--header "Authorization: Bearer $STATESET_API_KEY"
{
"has_more": true,
"limit": 20,
"next_cursor": "string",
"offset": 1,
"returns": [
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"refund_amount": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
],
"total": 102
}
Query parameters
integer (int32)
Maximum number of results to return (default: 50).
integer (int32)
Number of results to skip (default: 0). Ignored when
after cursor is set.string
Cursor for keyset pagination (opaque token from
next_cursor).string
Filter by order ID (UUID).
string
Filter by customer ID (UUID).
string
Filter by return status (requested, approved, rejected, received, refunded, closed).
string
Filter by return reason (defective,
wrong_item, not_as_described, changed_mind, other).string
Returns created on or after this date (RFC 3339).
string
Returns created on or before this date (RFC 3339).
Response
ReturnListResponse
boolean
required
Whether more results are available after this page.
integer (int32)
required
string,null
Opaque cursor for fetching the next page (keyset pagination).
integer (int32)
required
ReturnResponse[]
required
integer
required
Status codes
| Code | Meaning |
|---|---|
200 | List of returns |
400 | Invalid filter parameter |
curl --request GET \
--url 'https://api.stateset.com/api/v1/returns' \
--header "Authorization: Bearer $STATESET_API_KEY"
{
"has_more": true,
"limit": 20,
"next_cursor": "string",
"offset": 1,
"returns": [
{
"created_at": "2026-08-31T14:22:05Z",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"order_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reason": "Two-person tent, green — replacement for damaged pole set.",
"refund_amount": "49.00",
"status": "pending",
"updated_at": "2026-08-31T14:22:05Z"
}
],
"total": 102
}
Last modified on August 31, 2026