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

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

---

[API](https://skmtc.net/customeros/apis/customeros-api.md) · [All operations](https://skmtc.net/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/customeros/customeros-api/versions/73526747b270/schema)