---
search:
  tags:
    - Purchases
    - GET
seo:
  description: >-
    Any signed in user. Returns one received batch with medicine and supplier…
    Reference for the GET /api/v1/purchases/{batchId} endpoint in the PharmaFlow
    API.
sidebar:
  label: Read a received batch
  badge: GET
title: Read a received batch
type: openapi-operation
---
Any signed in user. Returns one received batch with medicine and supplier names joined. An unknown batch id is refused with 404 rather than answered with an empty document.

`GET /api/v1/purchases/{batchId}`

**Responses**

- `200` — The received batch
- `401` — Not authenticated
- `404` — Purchase not found

Response example, 200:

```json
{
  "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
}
```