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

# List invoices

`GET /v1/invoices`

Lists invoices for a billing account.

## Query parameters

- `id` string, required
- `pageSize` integer
- `startingAfter` string
- `status` string

## Response `200`

A successful response.

- ListInvoicesResponse
  - `hasMore` boolean, required
  - `invoices` Invoice[], required
    - `amountDue` string, int64
    - `amountPaid` string, int64
    - `amountRemaining` string, int64
    - `autoAdvance` boolean
    - `billingReason` string
    - `created` string, int64
    - `currency` string
    - `description` string
    - `dueDate` string, int64
    - `hostedInvoiceUrl` string
    - `id` string
    - `number` string
    - `paidDate` string, int64
    - `periodEnd` string, int64
    - `periodStart` string, int64
    - `status` string
    - `subtotal` string, int64
    - `subtotalExcludingTax` string, int64
    - `tax` string, int64
    - `total` string, int64
    - `totalExcludingTax` string, int64

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/cudocompute/apis/cudo-compute-service.md) · [All operations](https://skmtc.net/cudocompute/apis/cudo-compute-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cudocompute/cudo-compute-service/revisions/93dc40dababc/schema)