​
List Invoices

Retrieve a paginated list of all invoices in your account.

​
Endpoint

GET /api/invoices

​
Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
limitintegerNoNumber of items per page (default: 20)
statusstringNoFilter by status (draft, sent, paid, overdue)
customer_idstringNoFilter by customer

​
Response

Returns a list of invoice objects. 
{
  "data": [
    {
      "id": "inv_123456789",
      "customer_id": "cust_123456789",
      "amount": 250.00,
      "currency": "USD",
      "description": "Service invoice",
      "status": "sent",
      "due_date": "2023-02-01T00:00:00Z",
      "created_at": "2023-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}