---
title: "List return reasons"
method: GET
path: "/api/v1/returnReasons"
tags: ["Return Reason"]
---

# List return reasons

`GET /api/v1/returnReasons`

Returns a list of return reasons

## Query parameters

- `project` object — Project to optionally filter by
  - `id` string — Resource identifier.
- `language` string — Language code, 2-letter ISO code.

## Response `200`

Operation completed successfully.

- object
  - `data` object[] — Data representation of a list of return reasons
    - `id` string, required — Resource identifier.
    - `designation` string, required — Designation of the return reason
    - `description` string, required — Description of the return reason
    - `language` string, required — Language in which the return reason is written
    - `project` object, required — Project for the return reason
      - `id` string, required — Resource identifier.
  - `extra` object
    - `totalCount` integer, required — the total count of all items
    - `page` object, required — The pagination object containing the current page number and size
      - `number` integer, required — The current page number
      - `size` integer, required — The size of the pages

## Other responses

- `401` — Unable to authenticate the client
- `406` — Requested resource representation does not exist.

---

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