# List purchase orders

> Returns the purchase orders synced from your purchase order spreadsheet.

```
GET https://api.sandbox.stridehq.ai/v1/purchase_orders
```


Scope: `read`

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | No | How many to return. 1 to 100. |
| `starting_after` | string | No | The last id from the previous page. Use it when `has_more` is true. |
| `po_number` | string | No | Exact purchase order number. |
| `status` | string | No | `open` or `closed`. |

## Responses

- **200**: A page of purchase orders.
- **400**: `unknown_field`, `invalid_parameter` or `invalid_cursor`.
- **401**: `missing_api_key`, `invalid_api_key`, `revoked_api_key` or `wrong_environment`.

```json
{
  "object": "list",
  "data": [
    {
      "id": "po_2d4f6a8b0c1e3a5b7d9f1a2b3c4d5e6f",
      "object": "purchase_order",
      "po_number": "PO-2026-118",
      "brand": "Northwind Drinks",
      "campaign": "Autumn launch",
      "creator_name": "Maya Chen",
      "agreed_amount": 500000,
      "amount_invoiced": 250000,
      "remaining_amount": 250000,
      "currency": "GBP",
      "status": "open",
      "created_at": "2026-09-20T10:00:00Z"
    }
  ],
  "has_more": false
}
```