---
title: "GET /api/admin/invoices/list"
method: GET
path: "/api/admin/invoices/list"
tags: ["Operational"]
---

# GET /api/admin/invoices/list

`GET /api/admin/invoices/list`

**Enterprise feature**

undefined

## Response `200`

#/components/schemas/detailedInvoicesSchema

- DetailedInvoicesSchema — Detailed invoices response with nested line items
  - `planPrice` number — The plan price
  - `planCurrency` string — The currency code for the plan price
  - `invoices` object[], required — List of invoices with their line items
    - `invoiceDate` string, date-time, required — When the invoice was created
    - `dueDate` string, date-time — When the invoice is due
    - `status` string, required — The current status of the invoice
    - `totalAmount` number, required — Total amount for the invoice
    - `subtotal` number, required — Subtotal amount for the invoice
    - `currency` string, required — The currency code for the invoice
    - `taxAmount` number, required — Tax amount for the invoice
    - `taxPercentage` number, required — Tax percentage for the invoice
    - `invoiceURL` string, uri — A URL pointing to where the invoice can be found.
    - `invoicePDF` string, uri — A link to a PDF-version of the invoice.
    - `monthText` string, required — Human-readable month label for the invoice period
    - `mainLines` DetailedInvoicesLineSchema[], required — Primary line items (packages, seats, etc.)
      - `description` string, required — Description of the line item
      - `quantity` number, required — Quantity of the item
      - `totalAmount` number — Total amount for this line item in minor currency units
      - `currency` string, required — Currency code
      - `lookupKey` string, required — Lookup key identifying the product/pricing
      - `startDate` string, date-time — Optional start date for the metered period
      - `endDate` string, date-time — Optional end date for the metered period
      - `limit` number — Optional limit associated with the line item
      - `consumption` number — Optional consumption associated with the line item
      - `unitPrice` number — Unit price for the line item
    - `usageLines` DetailedInvoicesLineSchema[], required — Usage line items (traffic, consumption usage, overages)
      - `description` string, required — Description of the line item
      - `quantity` number, required — Quantity of the item
      - `totalAmount` number — Total amount for this line item in minor currency units
      - `currency` string, required — Currency code
      - `lookupKey` string, required — Lookup key identifying the product/pricing
      - `startDate` string, date-time — Optional start date for the metered period
      - `endDate` string, date-time — Optional end date for the metered period
      - `limit` number — Optional limit associated with the line item
      - `consumption` number — Optional consumption associated with the line item
      - `unitPrice` number — Unit price for the line item

---

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