---
search:
  tags:
    - Sales
    - GET
seo:
  description: >-
    Any signed in user. Returns a page of sales, newest first, with branch and
    receipt… Reference for the GET /api/v1/sales endpoint in the PharmaFlow API.
sidebar:
  label: List sales
  badge: GET
title: List sales
type: openapi-operation
---
Any signed in user. Returns a page of sales, newest first, with branch and receipt identity. A pharmacist sees only their sales, a manager or cashier only their branch, whatever is asked.

`GET /api/v1/sales`

**Responses**

- `200` — A page of sales
- `401` — Not authenticated

Response example, 200:

```json
{
  "total": -9007199254740991,
  "page": -9007199254740991,
  "page_size": -9007199254740991,
  "items": [
    {
      "id": "string",
      "branch_id": "string",
      "user_id": "string",
      "invoice_number": "string",
      "uuid": "string",
      "icv": -9007199254740991,
      "client_mutation_id": "string",
      "payload_hash": "string",
      "device_id": "string",
      "sync_status": "string",
      "subtotal_amount": "string",
      "vat_amount": "string",
      "total_amount": "string",
      "currency_code": "string",
      "fx_rate_to_base": "string",
      "base_currency_code": "string",
      "base_total_amount": "string",
      "vat_breakdown": [
        {
          "rate": 0,
          "taxable_amount": 0,
          "vat_amount": 0
        }
      ],
      "payment_method": "string",
      "payment_lines": [
        {
          "method": "string",
          "amount": 0
        }
      ],
      "notes": "string",
      "session_id": "string",
      "customer_id": "string",
      "customer_name": "string",
      "coupon_id": "string",
      "global_discount": "string",
      "coupon_discount": "string",
      "zatca_status": "string",
      "zatca_xml": "string",
      "zatca_hash": "string",
      "is_deleted": -9007199254740991,
      "sold_at": "string",
      "pharmacist_name": "string",
      "customer_display_name": "string",
      "branch_name": "string",
      "branch_address": "string",
      "branch_vat_number": "string",
      "organization_name": "string",
      "organization_legal_name": "string",
      "organization_phone": "string",
      "organization_email": "string",
      "organization_address": "string",
      "organization_tin": "string",
      "organization_vat_number": "string",
      "receipt_header": "string",
      "receipt_footer": "string",
      "return_policy": "string",
      "has_return": true
    }
  ]
}
```