---
search:
  tags:
    - Purchases
    - GET
seo:
  description: >-
    Any signed in user. Returns a page of received batches with medicine and
    supplier… Reference for the GET /api/v1/purchases endpoint in the PharmaFlow
    API.
sidebar:
  label: List received batches
  badge: GET
title: List received batches
type: openapi-operation
---
Any signed in user. Returns a page of received batches with medicine and supplier names. Search covers batch number, medicine, and supplier; hides written-off batches unless asked.

`GET /api/v1/purchases`

**Responses**

- `200` — A page of received batches
- `401` — Not authenticated

Response example, 200:

```json
{
  "total": -9007199254740991,
  "page": -9007199254740991,
  "page_size": -9007199254740991,
  "items": [
    {
      "id": "string",
      "medicine_id": "string",
      "branch_id": "string",
      "supplier_id": "string",
      "batch_number": "string",
      "expiry_date": "string",
      "manufacturing_date": "string",
      "qty_received": -9007199254740991,
      "qty_remaining": -9007199254740991,
      "unit_cost": "string",
      "status": "string",
      "sfda_status": "string",
      "created_at": "string",
      "medicine_name": "string",
      "medicine_selling_price": 0,
      "supplier_name": "string",
      "is_deleted": true
    }
  ]
}
```