# List invoices

> Returns your invoices, newest first.

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


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. |
| `sort` | string | No | One of `created_at`, `updated_at`, `due_date`, `invoice_date`, `total_amount`. Prefix with `-` for descending. |
| `status` | string | No | Only invoices with this status. |
| `creator_id` | string | No | Only this creator's invoices. |
| `purchase_order_id` | string | No | Only invoices against this purchase order. |
| `payment_run_id` | string | No | Only invoices in this payment run. |
| `due_before` | string (date) | No | Only invoices due before this date. |
| `created_after` | string (date-time) | No | Only those created after this time. |
| `created_before` | string (date-time) | No | Only those created before this time. |

## Responses

- **200**: A page of invoices.
- **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": "inv_4b1e7d2a9c3f4e5d8a6b0c1d2e3f4a5b",
      "object": "invoice",
      "creator_id": "cre_8f3a2c1d9b7e4f60a1b2c3d4e5f60718",
      "invoice_number": "MC-0042",
      "invoice_date": "2026-10-10",
      "due_date": "2026-11-09",
      "purchase_order_id": "po_2d4f6a8b0c1e3a5b7d9f1a2b3c4d5e6f",
      "po_match": "matches",
      "description": "Autumn campaign, 3 videos",
      "net_amount": 250000,
      "vat_amount": 0,
      "total_amount": 250000,
      "currency": "GBP",
      "status": "approved",
      "action_required_reason": null,
      "rejection_reason": null,
      "payment_run_id": null,
      "payment_id": null,
      "has_file": true,
      "external_id": null,
      "metadata": {},
      "created_at": "2026-10-10T11:20:00Z",
      "updated_at": "2026-10-12T08:45:00Z"
    }
  ],
  "has_more": false
}
```