---
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

## Changes

- **2026-08-11** `42816b90d8d6` — 1 warning
  - added the new `signups_disabled` enum value to the `code` response property for the response status `default`
- **2026-06-23** `d0e78bae6ce1` — 1 warning
  - added the new `compute_limit_exceeded` enum value to the `code` response property for the response status `default`
- **2026-06-22** `bdf92f48aec1` — 1 info
  - added the optional property `code` to the response with the `default` status
- **2026-04-22** `cb6948daa61e` — 1 info
  - endpoint added
- **2026-04-17** `a7becb6668ec` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/timescale/apis/ghost-api/changes/spaces/:space_id/invoices/get.md)

---

[API](https://skmtc.dev/timescale/apis/ghost-api.md) · [All operations](https://skmtc.dev/timescale/apis/ghost-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/timescale/ghost-api/revisions/42816b90d8d6/schema)