---
title: "The org's invoices, newest first (owner/admin)"
method: GET
path: "/v1/orgs/{org_id}/billing/invoices"
tags: ["billing"]
---

# The org's invoices, newest first (owner/admin)

`GET /v1/orgs/{org_id}/billing/invoices`

## Request

- Base URL: `https://api.wavehouse.cloud`
- URL: `https://api.wavehouse.cloud/v1/orgs/{org_id}/billing/invoices`
- Auth: one of:
  - API key in cookie `whc_session`
  - HTTP bearer
  - API key in header `X-API-Key`

Read from the payment provider: number, status, period, subtotal, discount, tax, total, amount due, and the provider's invoice page and PDF. A discounted invoice of $0 still shows its subtotal. Empty for an org with no billing account.

## Path parameters

- `org_id` string, required

## Query parameters

- `limit` integer: page size; 0 or absent means 50
- `cursor` string: next_cursor from the previous page; absent for the first page

## Response `200`

OK

- InvoicePage
  - `data` InvoiceView[], required
    - `amount_due_micros` integer, required
    - `amount_paid_micros` integer, required
    - `created_at` string, date-time, required
    - `currency` string, required: ISO 4217
    - `discount_micros` integer, required: what discounts took off, as a positive amount
    - `hosted_invoice_url` string: the provider's page for the invoice, where an open one is paid; absent on a draft
    - `invoice_pdf_url` string: absent on a draft
    - `number` string, required: empty while the invoice is a draft
    - `period_end` string, date-time
    - `period_start` string, date-time: start of the period the invoice bills; absent when it names none
    - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible', required
    - `subtotal_micros` integer, required: before discounts and tax: what it would have cost
    - `tax_micros` integer, required
    - `total_micros` integer, required
  - `next_cursor` string, nullable, required: pass as cursor to fetch the next page; null on the last page

## Other responses

- `429`: Rate limited, per client IP, API key or org; a client IP is also refused on every route for a while after repeated authentication failures. A limited operation carries RateLimit-Policy and RateLimit on every response; wait Retry-After seconds before retrying.
- `default`: Error

---

[API](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api.md) · [All operations](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wavehouse/apis/wavehouse-cloud-api/revisions/adea029bf505?raw)