---
title: "Get a list of invoices"
method: GET
path: "/organization/{organization_id}/invoices"
tags: ["OrganizationBillingGroup"]
---

# Get a list of invoices

`GET /organization/{organization_id}/invoices`

## Path parameters

- `organization_id` string, required

## Query parameters

- `billing_group_ids` unknown[]
  - unknown
- `state` unknown[]
  - unknown
- `starting_date` string
- `ending_date` string

## Response `200`

Response

- OrganizationBillingInvoiceListResponse — OrganizationBillingInvoiceListResponse
  - `invoices` object[], required — A list of billing invoices belonging to the organization
    - `billing_group_id` string, required — Billing group ID
    - `create_time` string, required — The date when this invoice was created
    - `currency` 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'JPY' | 'NOK' | 'NZD' | 'SEK' | 'SGD' | 'USD', required — Acceptable currencies for a billing group.
    - `download_only` boolean, required — Download only
    - `due_date` string — The date when this invoice is due
    - `invoice_number` string, required — Invoice ID
    - `invoice_period` object, required — InvoicePeriod
      - `begin_time` string, required — The start date of the period this invoice refers to
      - `end_time` string, required — The end date of the period this invoice refers to
    - `issue_date` string, required — The date the invoice was issued
    - `net` string, required — Total invoice amount without taxes in local currency
    - `net_usd` string, required — Total invoice amount without taxes in USD
    - `organization_id` string, required — Organization ID
    - `state` 'accrual' | 'consolidated' | 'due' | 'estimate' | 'failed_credit_card_charge' | 'failed_no_credit_card' | 'mailed' | 'no_payment_expected' | 'paid' | 'partner_metering' | 'uncollectible' | 'waived' | 'due_only_project_charges_calculated' | 'estimate_only_project_charges_calculated', required — State of the invoice
    - `total` string, required — Total invoice amount including taxes in local currency
    - `total_usd` string, required — Total invoice amount including taxes in USD

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/9891b22cfd6a/schema)