---
title: "Lightning - List Invoices"
method: GET
path: "/api/v2/wallet/{walletId}/lightning/invoices"
tags: ["Lightning"]
---

# Lightning - List Invoices

`GET /api/v2/wallet/{walletId}/lightning/invoices`

List Lightning Network invoices for the given wallet.

## Path parameters

- `walletId` string, required

## Request body

- ExpressCreateInvoiceRequest — Create invoice request. Provide exactly one of `valueMsat` or `valueSat`
  - `valueSat` number — The invoice amount in satoshis
  - `valueMsat` string — The invoice amount in millisatoshis
  - `memo` string — Optional description for the invoice
  - `expiry` number — Optional expiration time in seconds

## Response `200`

OK

- ExpressListInvoicesResponse[]
  - `valueMsat` string — Amount in millisatoshis
  - `valueSat` number — Amount in satoshis
  - `paymentHash` string — Payment hash of the invoice
  - `invoice` string — The BOLT 11 encoded invoice string
  - `walletId` string — The public BitGo walletId to which this invoice belongs to
  - `status` 'open' | 'settled' | 'canceled' — Current status of the invoice
  - `expiresAt` string, date-time — Expiration date in ISO format
  - `createdAt` string, date-time — Creation date in ISO format
  - `updatedAt` string, date-time — Last update date in ISO format
  - `amtPaidMsat` string — Amount actually paid in millisatoshis (may be greater than valueMsat)

## Other responses

- `400` — Bad Request

---

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