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

# List invoices

`GET /billing/v1/invoices`

Returns a list of all the current and historical invoices for your organization.
Invoices are returned in reverse chronological order by default.

## Query parameters

- `maxResults` integer
- `pageToken` string
- `filter` string — An expression for filtering the results. The syntax is `key:[<value>]`. Multiple filters can be connected using a pipe |. See [Filters](https://developer.doit.com/docs/filters).
- `minCreationTime` integer
- `maxCreationTime` integer

## Response `200`

OK - All available invoices returned.

- object
  - `invoices` InvoiceListItem[] — Array of Invoices
    - `id` string — Invoice number, identifying the invoice.
    - `invoiceDate` integer — The time when this invoice was issued, in milliseconds since the epoch.
    - `platform` 'google-cloud' | 'amazon-web-services' | 'microsoft-azure' | 'g-suite' | 'office-365' | 'superquery' | 'looker' | 'navigator' | 'solve' — Platform identifier for invoice source.
    - `dueDate` integer — The last day to pay the invoice, in milliseconds since the epoch
    - `status` 'OPEN' | 'PAST DUE' | 'PAID' — Status of the invoice
    - `totalAmount` number, double — Total invoiced amount
    - `balanceAmount` number, double — Invoice balance to be paid
    - `currency` 'USD' | 'ILS' | 'EUR' | 'AUD' | 'CAD' | 'GBP' | 'DKK' | 'NOK' | 'SEK' | 'BRL' | 'SGD' | 'MXN' | 'CHF' | 'MYR' | 'TWD' | 'EGP' | 'ZAR' | 'JPY' | 'IDR' | 'AED' | 'THB' | 'COP' — Currency code for monetary values.
    - `url` string — Link to [invoice details page](https://help.doit.com/docs/billing/invoices-and-payments/managing-invoices) in the DoiT console. You can download the PDF invoice from the invoice details page.
  - `pageToken` string — Page token. Can be used to request the next page of results.
  - `rowCount` integer — Invoice rows count

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `404` — Not Found - The requested resource does not exist.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)