---
title: "The workspace's recent invoices (owners and admins)"
method: GET
path: "/billing/invoices"
tags: ["Billing"]
---

# The workspace's recent invoices (owners and admins)

`GET /billing/invoices`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/billing/invoices`
- Auth: HTTP bearer

Read from Stripe, newest first. Requires `billing:manage`.

## Response `200`

Invoices

- object
  - `invoices` Invoice[]
    - `id` string
    - `number` string
    - `status` string: Stripe invoice status: draft, open, paid, uncollectible or void.
    - `amount_due_cents` integer
    - `amount_paid_cents` integer
    - `currency` string
    - `created_at` string, date-time, nullable
    - `hosted_invoice_url` string, nullable
    - `invoice_pdf` string

## Other responses

- `401`: Error envelope: {code, title, details}.
- `403`: Error envelope: {code, title, details}.
- `503`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)