> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleo-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List invoices

> GET /v1/invoices lists the invoices the business sent its customers, newest first, with a status filter and search.

```
GET /v1/invoices
```

**Scope:** `invoices:read`

<ParamField query="page" type="integer" default="1">Page number.</ParamField>
<ParamField query="pageSize" type="integer" default="25">1 to 100.</ParamField>
<ParamField query="status" type="string">`draft`, `open`, `paid`, `void`, `declined` or `blocked`.</ParamField>
<ParamField query="search" type="string">Matches the invoice number, public id or customer name.</ParamField>

```bash theme={null}
curl "https://api.stg.cleo-pay.com/v1/invoices?status=open" \
  --header "Authorization: Bearer $CLEO_API_KEY"
```

## Response

`200` with `{ items, totalCount }`, newest first. Each item is an [invoice](/api-reference/invoices/get) without line items.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.