---
search:
  tags:
    - PurchaseOrders
    - GET
seo:
  description: >-
    Admin, branch manager, or auditor. Returns the hundred newest orders with
    their… Reference for the GET /api/v1/purchase-orders endpoint in the
    PharmaFlow API.
sidebar:
  label: List purchase orders
  badge: GET
title: List purchase orders
type: openapi-operation
---
Admin, branch manager, or auditor. Returns the hundred newest orders with their item counts. The filters cover branch, supplier, and status, and an unfiltered call spans every branch.

`GET /api/v1/purchase-orders`

**Responses**

- `200` — The recent purchase orders
- `401` — Not authenticated
- `403` — Access forbidden for this role

Response example, 200:

```json
{
  "items": [
    {
      "id": "string",
      "supplier_id": "string",
      "branch_id": "string",
      "status": "string",
      "expected_date": "string",
      "notes": "string",
      "created_by": "string",
      "created_at": "string",
      "updated_at": "string",
      "supplier_name": "string",
      "branch_name": "string",
      "created_by_name": "string",
      "item_count": -9007199254740991
    }
  ],
  "total": -9007199254740991
}
```