---
title: "Get organization's invoices"
method: GET
path: "/billing/v1/organizations/{id}/invoices"
tags: ["Billing API"]
---

# Get organization's invoices

`GET /billing/v1/organizations/{id}/invoices`

## Request

- Base URL: `https://api.customeros.ai`
- URL: `https://api.customeros.ai/billing/v1/organizations/{id}/invoices`
- Auth: API key in header `X-CUSTOMER-OS-API-KEY`
- TypeScript: <https://skmtc.dev/customeros/apis/customeros-api/docs/billing/v1/organizations/:id/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves all non-dry-run invoices for a specific organization, sorted by due date descending

## Path parameters

- `id` string, required

## Response `200`

List of invoices retrieved successfully

- BillingInvoicesResponse: Response containing multiple invoices
  - `invoices` BillingInvoiceRecord[]: List of invoices required: false
    - `amount` number: Total amount due for the invoice required: true example: 1500.50 minimum: 0
    - `currency` string: Currency code for the invoice amount required: true example: USD pattern: ^[A-Z]{3}$
    - `dueDate` string: Date when the invoice payment is due required: true example: 2024-12-01T00:00:00Z format: date-time
    - `id` string: Unique identifier for the invoice required: true example: 123e4567-e89b-12d3-a456-426614174000 format: uuid
    - `invoiceStatus` string: Current status of the invoice required: true example: PAID enum: DRAFT,PENDING,PAID,OVERDUE,CANCELLED,VOID
    - `number` string: Invoice number or reference required: true example: INV-2024-001 minLength: 1
    - `paymentLink` string: URL where the invoice can be paid required: false example: https://payment.example.com/inv/12345 format: uri
    - `publicUrl` string: Public URL to access the invoice PDF required: false example: https://invoices.example.com/12345.pdf format: uri
  - `requestId` string
  - `status` string: Status indicates the result of the operation ("success" or "error")

## Other responses

- `206`: Invoices retrieved with some errors fetching public URLs
- `400`: Invalid organization ID format
- `401`: Unauthorized - Invalid or missing API key
- `404`: Organization not found
- `500`: Internal server error

## Changes

- **2026-07-17** `73526747b270`: 1 info
  - added the success response with the status `206`
- **2024-10-15** `17921b6215b0`: 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/customeros/apis/customeros-api/changes/billing/v1/organizations/:id/invoices/get.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) - [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) - [OpenAPI document](https://skmtc.dev/customeros/apis/customeros-api/revisions/73526747b270?raw)