# Return volume

**GET /v1/returns/volume**

Returned unit and order counts for the authenticated organization, including a daily series. Combines Pattern warehouse returns with Amazon FBA returns (`amazon_returns`).


## Servers
- Public API: https://api.pattern.com/hub (Public API)
- Staging API: https://stage-api.pattern.com/hub (Staging API)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters

- **start_date** (string)
  ISO date (YYYY-MM-DD), inclusive. Defaults to 30 days before end_date when omitted.

- **end_date** (string)
  ISO date (YYYY-MM-DD), inclusive. Defaults to today when omitted.

- **warehouses[]** (array)
  Filter by Pattern warehouse name. When set, Amazon FBA returns are omitted.

- **vendors[]** (array)
  Filter by vendor name among vendors on the authenticated org.



## Responses
### 200
volume retrieved successfully

#### Body: application/json (object)
- **units** (integer)
  Returned units in the window

- **orders** (integer)
  Distinct returned orders in the window

- **series** (array[object])
  Daily returned units and orders


### 422
malformed date

#### Body: application/json (object)
- **errors** (array[string])



[Powered by Bump.sh](https://bump.sh)