---
title: "GET /billing/invoices"
method: GET
path: "/billing/invoices"
---

# GET /billing/invoices

`GET /billing/invoices`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/billing/invoices`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `limit` integer: Max invoices to return
- `cursor` string: Stripe invoice ID to paginate after

## Response `200`

OK

- object
  - `items` object[], required: List of invoices
    - `id` string, required: Stripe invoice ID
    - `number` string, nullable, required: Human-readable invoice number
    - `date` string, date-time, required: ISO 8601 timestamp when the invoice was created
    - `amountPaid` integer, required: Amount paid in cents
    - `currency` string, required: Three-letter ISO currency code
    - `status` 'draft' | 'open' | 'paid' | 'uncollectible' | 'void', nullable, required: Invoice payment status
    - `hostedUrl` string, uri, nullable, required: URL to Stripe-hosted invoice page
    - `pdfUrl` string, uri, nullable, required: URL to download invoice PDF
    - `description` string, nullable, required: Invoice description or memo
  - `hasMore` boolean, required: Whether more invoices are available

---

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