Skip to main content

​
Object structure

JSON
{
  "id": "l11_abc123xyz",
  "object": "lightning_invoice_bolt11",
  "amount": 12345600,
  "d_tag_memo": "Payment for order #7890",
  "h_tag_memo": "f2ca1bb6c7e907d06dafe4687e579fce76c70fd6",
  "collect": "col_98765",
  "expiry_interval": 3600,
  "metadata": {
    "order_id": "7890",
    "customer_id": "cust_456"
  },
  "status": "active",
  "payment_status": "unpaid",
  "created_at": "2025-09-28T08:15:30Z",
  "updated_at": "2025-09-28T08:20:45Z"
}

​
Object Parameters

FieldtypeDescription
idstringUnique ID of the object
objectenumThis is lightning_invoice_bolt11 here
amountintegerAmount in BTC. The precision is 8 decimal places
d_tag_memostringThis will be included in the d-tag. If both d_tag_memo and h_tag_memo are provided, only h_tag will be used
h_tag_memostringSHA-256 of the d_tag_memo. If both d_tag_memo and h_tag_memo are provided, only h_tag_memo will be used
expiry_intervalintegerThe expiry of the invoice in seconds. Default value is 3600 (1 hour).
collectstringCollect ID which is created when the invoice gets funded
statusenumactive, expired
payment_statusenumpaid, unpaid
created_attimestampTimestamp at which this object was created
updated_attimestampTimestamp at which this object was last updated
metadatajsonSet of key-value pairs attached to the object