List Sales Credits
GET/api/v2/sales-credits
Returns a paginated list of sales credits using the standard list interface. Supports search, archiving filter, and column selection.
orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
This endpoint uses the standard list interface. Common filters are passed as query parameters directly.
Response is wrapped with table_specifications metadata when table_specifications parameter is provided.
Totals fields:
- total: total credit amount
- refund_payments_total: sum of cash/card refunds against the credit (always positive)
- applied_to_other_total: sum of credit consumed by Loop Returns EXC-* exchange orders (always positive)
- fees_retained_total: sum of fees Loop withheld out of the customer's credit — return shipping, restocking, etc. (always positive)
- outstanding_amount: total minus (refund_payments_total + applied_to_other_total + fees_retained_total), clamped to zero (i.e., the unrefunded, unapplied balance still owed back to the customer)
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.