---
title: "Get Invoice"
method: GET
path: "/api/v1/invoices/{invoiceId}"
tags: ["Subscription Invoices"]
---

# Get Invoice

`GET /api/v1/invoices/{invoiceId}`

This retrieves the details of a specific invoice.

## Path parameters

- `invoiceId` integer, required

## Response `200`

Request Successful

- GetInvoiceResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message regarding the operation.
  - `data` object — The payload containing the detailed invoice record.
    - `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.

## 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)