List Returns
Returns
List Returns
List normalized, PII-free marketplace returns with SKU-level lines. Requires returns:read. Use updatedSince and cursor for bootstrap/recovery alongside return webhooks.
GET
List Returns
Authorizations
Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.
Query Parameters
Optional organization scope for session-authenticated calls. OAuth client credentials resolve the organization from the token.
Maximum string length:
120Required range:
1 <= x <= 250