---
title: "List invoices"
method: GET
path: "/invoices"
tags: ["Invoices"]
---

# List invoices

`GET /invoices`

## Request

- Base URL: `https://www.billingengine.com/api/v1`
- URL: `https://www.billingengine.com/api/v1/invoices`
- Auth: HTTP bearer

All invoices, newest first.

## Query parameters

- `status` 'draft' | 'open' | 'overdue' | 'paid' | 'cancelled' | 'cancellation'
- `customer_id` integer
- `after` string, date
- `before` string, date
- `number` string
- `page` integer
- `per_page` integer

## Response `200`

A page of invoices.

- object
  - `data` Invoice[], required
    - `id` integer
    - `number` string
    - `date` string, date
    - `due_date` string, date, nullable
    - `customer` CustomerReference
      - `id` integer
      - `name` string
    - `delivery_status` 'draft' | 'sent' | 'downloaded'
    - `payment_status` 'open' | 'paid' | 'defaulted' | 'cancelled' | 'cancellation'
    - `overdue` boolean
    - `cancelled` boolean
    - `cancellation` boolean: True for a cancellation invoice (credit note) of another invoice.
    - `currency` string
    - `prices_include_tax` boolean
    - `net_amount` number
    - `tax_amount` number
    - `gross_amount` number
    - `open_amount` number
  - `pagination` Pagination, required
    - `page` integer, required
    - `per_page` integer, required
    - `pages` integer, required
    - `count` integer, required

## Other responses

- `400`: Malformed request: missing parameter, invalid JSON, invalid date or invalid filter.
- `401`: Missing or invalid API key.
- `403`: The API is not available in the Free plan, or the monthly invoice maximum of the plan has been reached.

---

[API](https://skmtc.dev/billingengine/apis/billingengine-api.md) · [All operations](https://skmtc.dev/billingengine/apis/billingengine-api/llms.txt) · [OpenAPI document](https://skmtc.dev/billingengine/apis/billingengine-api/revisions/71d8ea5fb554?raw)