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

# List payment invoices

`GET /api/billing/invoices`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/billing/invoices`
- Auth: HTTP bearer

Returns a list of paid invoices with invoice number, amount, date, and links to view or download the PDF. Invoices are generated automatically for every domain purchase, renewal, and transfer.

## Query parameters

- `limit` integer

## Response `200`

List of invoices

- object
  - `invoices` object[]
    - `id` string
    - `number` string, nullable
    - `status` string
    - `amount_due` integer: Amount in cents
    - `amount_paid` integer: Amount in cents
    - `currency` string
    - `description` string, nullable
    - `created` string, date-time
    - `hosted_invoice_url` string, uri, nullable: URL to view the invoice in browser
    - `invoice_pdf` string, uri, nullable: Direct PDF download URL
  - `has_more` boolean
  - `hint` string

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)