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

## Changes

- **2026-07-28** `ecc1b4776164` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smallest-inc/apis/agent-management-api/changes/payment/v1/invoices/get.md)

---

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