---
title: "Get an invoice by ID"
method: GET
path: "/v1/invoices/{invoiceId}"
tags: ["Invoices"]
---

# Get an invoice by ID

`GET /v1/invoices/{invoiceId}`

## Path parameters

- `invoiceId` string, required

## Response `200`

Success

- object — The invoice
  - `status` 'SUCCEEDED', required
  - `data` GetInvoiceResponse, required
    - `id` string, required
    - `status` 'PENDING' | 'PAID' | 'EXPIRED' | 'GRACE_PERIOD' | 'CANCELED', required
    - `subscriptionId` string
    - `paymentPageId` string
    - `amount` number, required
    - `currency` 'USD' | 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'NZD' | 'PLN' | 'SEK' | 'SGD' | 'TWD' | 'KRW' | 'SOL' | 'USDC' | 'USDT' | 'HONEY' | 'EURC', required
    - `billingPeriod` object
      - `start` number, required
      - `end` number, required
    - `customerId` string, required
    - `dueAt` number, required
    - `expiredAt` number, required
    - `previousInvoiceId` string
    - `livemode` boolean, required
    - `merchantId` string, required
    - `statusUpdatedAt` number
    - `canceledAt` number

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

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