---
title: "List Returns"
method: GET
path: "/returns"
tags: ["Returns"]
---

# List Returns

`GET /returns`

Retrieves a list of return transactions. You can filter the results based on parameters such as status, date, and transaction type. This endpoint is available in Sandbox and Production environments.

## Query parameters

- `customer_uid` string — The UID of the customer requesting a return.
- `requestor_type` 'customer' | 'subclient' — Type of the customer requesting a return.

## Response `200`

A list of Returns is returned

- object
  - `created_at` string — The DateTime at which this Return was created.
  - `external_uid` ExternalUid — unresolved $ref
  - `original_transaction_uid` OriginalTransactionUid — unresolved $ref
  - `customer_uid` Schema — unresolved $ref
  - `requestor_type` Schema — unresolved $ref
  - `return_reason` ReturnReason — unresolved $ref
  - `return_transaction_uid` string — The transaction returning the funds.
  - `status` 'canceled' | 'queued' | 'pending' | 'settled' | 'failed' — A value indicating the overall status of the Return.
  - `uid` string — Unique identifier for the Return

## Other responses

- `403` — Denied access to Returns
- `422` — Failed to retrieve Returns

---

[API](https://skmtc.net/newline53/apis/newline-platform-api.md) · [All operations](https://skmtc.net/newline53/apis/newline-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newline53/newline-platform-api/revisions/54f4fe726d8f/schema)