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

# List billing invoices

`GET /v1/billing/invoice`

Returns finalized invoices and their complete line items for the authenticated account, newest first. All monetary amounts are in the currency's smallest unit.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- object
  - `data` BillingInvoice[], required
    - `amount_due` integer, required
    - `amount_paid` integer, required
    - `amount_remaining` integer, required
    - `created_at` string, date-time, required
    - `credit_memo_ids` string[], required
    - `currency` string, required
    - `discount_amount` integer, required
    - `invoice_id` string, required
    - `issued_at` string, date-time, required — The date of issue printed on the invoice PDF.
    - `line_items` BillingInvoiceLineItem[], required
      - `description` string, required
      - `device_ids` string[], required — Devices the line covers; consolidated lines list one entry per device. Empty when the line is not attributable to devices.
      - `discount_amount` integer, required
      - `proration` boolean, required
      - `quantity` integer
      - `service_period_end` string, date-time
      - `service_period_start` string, date-time
      - `sku` string — Slide catalog identifier (service model ID or hardware SKU). Absent when the line is not attributable to a catalog item.
      - `subtotal_amount` integer, required — Gross line amount before discounts and exclusive tax. Inclusive tax, when present, is already included.
      - `tax_amount` integer, required — Total inclusive and exclusive tax attributed to the line.
      - `total_amount` integer, required — Final line amount after discounts and tax.
      - `unit_amount` integer — Set only when the line is billed per unit.
    - `number` string, required
    - `status` 'open' | 'paid' | 'uncollectible' | 'void', required
    - `subtotal_amount` integer, required
    - `tax_amount` integer, required
    - `total_amount` integer, required
  - `pagination` Pagination, required
    - `next_offset` integer — Next offset to use for pagination. If this field is not present, that indicates there are no more items to fetch.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

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