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

# List invoices

`GET /payment/v1/invoices`

Returns up to 20 of the most recent Stripe invoices for the caller's
organization. Each item is the raw Stripe `Invoice` object; use the
canonical Stripe reference at
[stripe.com/docs/api/invoices/object](https://stripe.com/docs/api/invoices/object)
for field-level semantics.

Organizations that have never been charged (free-tier only) return
an empty array.

## Response `200`

Up to 20 recent Stripe invoices for the caller's organization.

- BillingInvoiceListResponse
  - `success` boolean, required
  - `data` object[], required — Up to 20 recent Stripe `Invoice` objects for the caller's organization. Fields follow the canonical Stripe shape. Keys most callers use: `id`, `status`, `amount_paid`, `amount_due`, `currency`, `created`, `hosted_invoice_url`, `invoice_pdf`, `number`.

## Other responses

- `401` — Unauthorized access

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)