Ctrl+K

Lightning - List Invoices

get/api/v2/wallet/{walletId}/lightning/invoices

List Lightning Network invoices for the given wallet.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$

Request Body

valueMsat string required
The invoice amount in millisatoshis
memo string
Optional description for the invoice
expiry number
Optional expiration time in seconds

200 Response

Array of
valueMsat string
Amount in millisatoshis
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 string
Current status of the invoice
Allowed values: open settled canceled
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)

400 Response

One of
error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code