---
title: "List invoices"
method: GET
path: "/spaces/{space_id}/invoices"
---

# List invoices

`GET /spaces/{space_id}/invoices`

Lists the most recent invoices for a space.
Requires a user JWT; API keys are not authorized.

## Path parameters

- `space_id` string, required

## Response `200`

List of invoices

- InvoicesResponse — A list of invoices for a space.
  - `invoices` Invoice[], required — Recent invoices, most recent first.
    - `id` string, required — Opaque invoice ID used to look up invoice details.
    - `invoice_number` string, required — Human-readable invoice number (e.g. "INV-12345").
    - `invoice_date` string, date-time, required — Date the invoice was issued.
    - `total` number, double, required — Invoice total.
    - `status` 'paid' | 'issued' | 'delinquent', required — Invoice status: - `paid` — invoice has been paid. - `issued` — invoice has been issued and is within its net-terms payment window (not yet paid, not yet delinquent). - `delinquent` — payment has failed and the invoice needs to be resolved by the user.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/timescale/apis/ghost-api.md) · [All operations](https://skmtc.net/timescale/apis/ghost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timescale/ghost-api/versions/808022f897be/schema)