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

# List Invoices

> Returns a list of invoices issued by your business.

Returns a paginated list of invoices. Invoices are returned in reverse chronological order.

***

### Query Parameters

**limit** `integer` (default: 10)

A limit on the number of objects to be returned, between `1` and `100`.

**status** `string`

Filter invoices by status: `draft`, `open`, `paid`, `uncollectible`, or `void`.

**customer** `string`

The ID of the customer whose invoices you want to retrieve.

***

### Code Examples

```bash cURL theme={null}
curl -G https://api.viarosandbox.com/v1/invoices \
  -u sk_test_uLsofsae3tB9Izwgeuy0Mxbh4JIxUPSG: \
  -d limit=10
```

```python Python theme={null}
import requests

url = "https://api.viarosandbox.com/v1/invoices"
auth = ("sk_test_uLsofsae3tB9Izwgeuy0Mxbh4JIxUPSG", "")

response = requests.get(url, auth=auth, params={"limit": 10})
print(response.json())
```

```javascript Node.js theme={null}
const axios = require('axios');

async function listInvoices() {
  const response = await axios.get('https://api.viarosandbox.com/v1/invoices', {
    auth: {
      username: 'sk_test_uLsofsae3tB9Izwgeuy0Mxbh4JIxUPSG',
      password: ''
    },
    params: { limit: 10 }
  });

  console.log(response.data);
}

listInvoices();
```

***

### Response

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "in_1a2b3c4d5e6f",
      "object": "invoice",
      "customer": "cus_9f1a2b3c4d5e",
      "amount_due": 75000,
      "amount_paid": 75000,
      "currency": "XAF",
      "status": "paid",
      "description": "Enterprise consulting retainer - November 2026",
      "hosted_invoice_url": "https://invoice.viarosandbox.com/i/in_1a2b3c4d5e6f",
      "created_at": "2026-11-06T12:00:00Z"
    }
  ],
  "has_more": false
}
```


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