Ctrl+K

Lightning - Create A Lightning Invoice

post/api/v2/{coin}/wallet/{walletId}/lightning/invoice

Create a Lightning Network Daemon (LND) invoice for the given wallet.

Path Parameters

  • coinstringRequired
    A lightning coin name.
    Example: lnbtc
  • 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

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
status string
Current status of the invoice
Allowed values: open settled canceled
expiresAt string
Expiration date in ISO format
memo string
Optional memo field

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