# InvoiceList

> A page of Invoice objects.

A page of Invoice objects.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `data` * | array of [Invoice](/docs/api/objects/invoice/) |  |
| `next_cursor` * | string or null | Pass as `cursor` to get the next page; null on the last page. |
| `has_more` * | boolean |  |

\* always present

## Example

```json
{
  "data": [
    {
      "id": "inv_01jbx2m9k7q4r8t5v6w3y0z1pr",
      "number": "GUV-2026-000123",
      "status": "draft",
      "period_start": "2026-10-22T13:05:00Z",
      "period_end": "2026-10-22T13:05:00Z",
      "subtotal": {
        "amount": "7.42",
        "currency": "GBP",
        "display": "£7.42"
      },
      "vat": {
        "amount": "7.42",
        "currency": "GBP",
        "display": "£7.42"
      },
      "total": {
        "amount": "7.42",
        "currency": "GBP",
        "display": "£7.42"
      },
      "lines": [
        {
          "description": "string",
          "quantity": "string",
          "unit": "string",
          "amount": {
            "amount": "7.42",
            "currency": "GBP",
            "display": "£7.42"
          }
        }
      ],
      "hosted_url": "https://guv.dev/",
      "pdf_url": "https://guv.dev/",
      "issued_at": "2026-10-22T13:05:00Z",
      "paid_at": "2026-10-22T13:05:00Z"
    }
  ],
  "next_cursor": "string",
  "has_more": false
}
```

## Used by

- [List invoices](/docs/api/spend/#list-invoices)