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

# List invoices

`GET /invoices`

Returns all invoices for your account, newest first.

## Response `200`

OK

- Invoice[]
  - `id` integer
  - `description` string
  - `status` 'new' | 'paid' | 'failed' | 'cancelled'
  - `total` number, float
  - `due_date` integer — Unix timestamp (UTC)
  - `created_at` integer
  - `items` InvoiceItem[]
    - `product_type` 'credit' | 'metered_plan' | 'metered_data' | 'static_proxies' | 'unlimited_plan'
    - `name` string
    - `price_per_unit` number, float
    - `quantity` integer

---

[API](https://skmtc.dev/proxiware/apis/proxiware-api.md) · [All operations](https://skmtc.dev/proxiware/apis/proxiware-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proxiware/proxiware-api/revisions/4e98e5b8cc44/schema)