---
title: "List Billing Invoices"
method: GET
path: "/api/v1/billing/invoices"
tags: ["billing"]
---

# List Billing Invoices

`GET /api/v1/billing/invoices`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/billing/invoices`
- Auth: none declared

A page of the workspace's invoices, newest first.

## Query parameters

- `cursor` string, nullable

## Response `200`

Successful Response

- BillingInvoicePage
  - `invoices` BillingInvoice[], required
    - `id` string, required
    - `number` string, nullable, required
    - `created_at` string, date-time, required
    - `due_at` string, date-time, nullable, required
    - `paid_at` string, date-time, nullable, required
    - `total` integer, required
    - `amount_remaining` integer, required
    - `currency` string, required
    - `status` 'PAID' | 'DUE' | 'OVERDUE' | 'PROCESSING' | 'PAYMENT_FAILED' | 'UNPAID' | 'VOID', required
    - `hosted_invoice_url` string, required
    - `invoice_pdf` string, required
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

## Changes

> 65 revisions in range; 1 not diffed.

- **2026-10-23** `f33170a380e2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/billing/invoices/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) - [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/6c872277d82b?raw)