---
title: "Get all the items filtered on return status"
method: GET
path: "/v3/returns"
tags: ["Returns V3"]
---

# Get all the items filtered on return status

`GET /v3/returns`

The items will be sorted on status modified time in reverse chronological order. Additionally we provide cursor based pagination via next link. This endpoint is limited to at max 50 results per page

## Query parameters

- `limit` integer
- `page` integer
- `status` 'MISDIRECTED' | 'ANNOUNCED' | 'ACCEPTED' | 'REJECTED'

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized to access
- `403` — Forbidden
- `404` — Item not found
- `500` — Internal server error

---

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