---
search:
  tags:
    - Returns
    - GET
seo:
  description: >-
    Any signed in user. Returns one return with its lines, original sale uuid…
    Reference for the GET /api/v1/returns/{returnId} endpoint in the PharmaFlow
    API.
sidebar:
  label: Read a return
  badge: GET
title: Read a return
type: openapi-operation
---
Any signed in user. Returns one return with its lines, original sale uuid and credit amount. The read is pinned to the caller's branch, so a return filed elsewhere is refused with 404.

`GET /api/v1/returns/{returnId}`

**Responses**

- `200` — The return and its lines
- `401` — Not authenticated
- `404` — Return not found

Response example, 200:

```json
{
  "id": "string",
  "sale_id": "string",
  "branch_id": "string",
  "processed_by": "string",
  "client_mutation_id": "string",
  "device_id": "string",
  "sync_status": "string",
  "reason": "string",
  "total_refund": "string",
  "created_at": "string",
  "processed_by_name": "string",
  "original_invoice": "string",
  "credit_note_number": "string",
  "original_uuid": "string",
  "credit_amount": 0,
  "items": [
    {
      "id": "string",
      "return_id": "string",
      "sale_item_id": "string",
      "quantity": -9007199254740991,
      "restockable": true,
      "reason": "string",
      "medicine_id": "string",
      "medicine_name": "string",
      "unit_price": "string",
      "vat_rate": "string"
    }
  ]
}
```