---
title: "List Invoices"
method: GET
path: "/subscription/api/v1/invoices?status={status}&subscriptionId={subscriptionId}&from={from}&to={to}&page={page}&size={size}"
tags: ["Subscription Invoices"]
---

# List Invoices

`GET /subscription/api/v1/invoices?status={status}&subscriptionId={subscriptionId}&from={from}&to={to}&page={page}&size={size}`

This retrieves a paginated list of invoices belonging to the authenticated merchant.

## Query parameters

- `status` string, required
- `subscriptionId` integer, required
- `from` string, date-time, required
- `to` string, date-time, required
- `page` integer, required
- `size` integer, required

## Response `200`

Request Successful

- ListInvoicesResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message regarding the operation.
  - `data` object — The payload containing the detailed, paginated list of invoices.
    - `content` object[] — The array of comprehensive invoice records.
      - `id` integer — Unique internal identifier for the invoice.
      - `invoiceNumber` string — The unique, human-readable invoice reference identifier.
      - `subscriptionId` integer — The identifier of the subscription associated with this invoice.
      - `cycleNumber` integer — The specific billing cycle sequence number this invoice represents.
      - `chargeId` integer, nullable — The transaction charge identifier tracking processing execution. Null if unpaid or draft.
      - `amount` number — The financial total amount billed on this invoice statement.
      - `currency` string — The 3-letter ISO currency code context attribute mapping.
      - `status` string — The transaction state of the invoice entity (e.g., DRAFT, PAID, UNPAID).
      - `dueDate` string, date-time — Timestamp tracking execution deadlines when payment collection finishes limit window lapses.
      - `issuedAt` string, date-time, nullable — Timestamp indicating exactly when the invoice was finalized and issued to the consumer layer.
      - `paidAt` string, date-time, nullable — Timestamp detailing absolute resolution validation completion settlement clearing.
      - `connectionMode` string — Environment tracking contextual mode tag indicator.
      - `createdAt` string, date-time — Record timeline insertion timestamp log entry.
      - `updatedAt` string, date-time — Record database modification tracking log entry baseline.
    - `pageable` object — Pagination sorting configuration parameters state snapshot context meta object properties layout.
      - `sort` object
        - `unsorted` boolean
        - `sorted` boolean
        - `empty` boolean
      - `pageNumber` integer — The current page selection counter index.
      - `pageSize` integer — The requested payload size limits constraint applied.
      - `offset` integer — The mathematical structural record array pointer offset value.
      - `paged` boolean
      - `unpaged` boolean
    - `totalElements` integer — The complete absolute index depth tracking matches globally active.
    - `totalPages` integer — The total volume allocation calculation matching sizes requirements.
    - `last` boolean — Indicates if page frame execution sequence finishes iteration structure bounds.
    - `numberOfElements` integer — Actual item total populated within the immediate payload snapshot content space.
    - `first` boolean — Indicates if page execution frame occupies the initial block orientation layout index.
    - `size` integer — Structural size specification bounds context config indicator.
    - `number` integer — The relative tracking page sequence index identity pointer location wrapper.
    - `sort` object — Global processing layout configuration indicators.
      - `sorted` boolean
      - `unsorted` boolean
      - `empty` boolean
    - `empty` boolean — Conditional summary verifying zero matches successfully pulled back.

## Other responses

- `400` — Invalid request

---

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