---
title: "Get returns"
method: GET
path: "/public/v1/returns"
tags: ["Return"]
---

# Get returns

`GET /public/v1/returns`

List returns, newest first (by return date), with optional filters: by customer (`company_ids`), by originating sales order (`order_ids`), by `statuses`, by custom field values (`custom_data`), and by the `inserted_datetime` / `return_datetime` / `updated_datetime` windows. When more than one filter is supplied they are combined with AND — a return must satisfy every filter to appear.

A return records product a customer sent back. It reverses the related inventory and financials, and — when the return is set to create a credit — generates a customer [credit](#model-compactcredit), which can sync to QuickBooks Online as a credit memo. A return is usually tied to the original sales [order](#model-compactorder); a return created without an order is a generic return and leaves the order-derived fields (`order`, `order_quantity`, `return_quantity`, `return_type`, `invoice_numbers`) empty.

Returned goods are added back to sellable inventory only once a return reaches `COMPLETED`; while `PROCESSING`, `SHIPPED`, or `RECEIVED` they are held aside as returning stock. Line items flagged as waste are written off rather than restocked.

Results are ordered by return date, newest first, and paginated. Follow the `next_page` URL in the response to fetch the following page rather than incrementing the page number yourself. This endpoint is eventually consistent: a change can take up to 1 second to appear here.

Required permission: `returns_permissions_view`.

## Query parameters

- `ids` string[]
- `company_ids` string[]
- `inserted_datetime` string
- `order_ids` string[]
- `owner_ids` string[]
- `statuses` string[]
- `page` string
- `return_datetime` string
- `updated_datetime` string
- `custom_data` object

## Response `200`

A list of returns

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)