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

# List invoices

`GET /api/v1/invoices`

## Request

- Base URL: `https://devs.adaptyvbio.com`
- URL: `https://devs.adaptyvbio.com/api/v1/invoices`
- Auth: HTTP bearer

Lists every invoice generated for the caller's organization so clients
can display billing history, monitor outstanding balances, and reconcile
payments. Results are sorted by creation date by default and include due dates,
currency, and current status for each invoice.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string
- `sort` string

## Response `200`

Invoice list

- object: Paginated list response with offset-based navigation metadata. All list endpoints return this shape. Use `offset` and `limit` query parameters to page through results; `total` reports how many items match the query across all pages.
  - `count` integer, required: Number of items in this response.
  - `items` object[], required: The page of results.
    - `amount_cents` integer, required: Total invoice amount in smallest currency unit (cents)
    - `created_at` string, date-time, required: ISO 8601 timestamp when invoice was created
    - `currency` string, required: ISO 4217 currency code (e.g., "usd")
    - `due_date` string, date-time, required: ISO 8601 date when payment is due
    - `hosted_invoice_url` string, nullable: Stripe-hosted URL where the customer can view and pay the invoice
    - `id` string, required: Unique invoice identifier (Stripe invoice ID, e.g. "in_xxx")
    - `invoice_number` string, required: Human-readable invoice number for reference
    - `organization_id` string, uuid, required: Organization ID that this invoice belongs to
    - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible', required: Invoice status from Stripe's API.
  - `offset` integer, required: Offset used for this page (mirrors the `offset` query parameter).
  - `total` integer, required: Total number of items matching the query (across all pages).

## Other responses

- `401`: Invalid or missing authentication token
- `403`: Insufficient permissions to view invoices
- `500`: Internal server error

---

[API](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api.md) - [All operations](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api/revisions/5a2228f4bd59?raw)