---
title: "List Stripe invoices"
method: GET
path: "/api/credits/invoices"
tags: ["v1", "credits"]
---

# List Stripe invoices

`GET /api/credits/invoices`

Recent Stripe invoices for the caller's active org, for billing managers.

The invoices belong to the org the request resolves to (the caller's
personal org when no ``X-Org-Id`` is supplied), so this is restricted to
org roles holding ``MANAGE_BILLING``.

Each item includes ``hosted_invoice_url`` (Stripe-hosted view) and
``invoice_pdf_url`` (direct PDF download). Returns an empty list when
the credit system is disabled or the org has no Stripe customer yet.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- InvoiceListItem[]
  - `id` string, required
  - `number` string, nullable
  - `created_at` string, date-time, required
  - `total_cents` integer, required
  - `amount_paid_cents` integer, required
  - `currency` string
  - `status` string, required
  - `description` string, nullable
  - `hosted_invoice_url` string, nullable
  - `invoice_pdf_url` string, nullable

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-05-01** `1080cb697505` — 1 info
  - endpoint added
- **2026-05-01** `772563af864e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/credits/invoices/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)