You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
34 lines
1.1 KiB
34 lines
1.1 KiB
LIGHTNING-LISTINVOICES(7)
|
|
=========================
|
|
:doctype: manpage
|
|
|
|
NAME
|
|
----
|
|
lightning-listinvoices - Protocol for querying invoice status
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*listinvoices* ['label']
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
The *listinvoices* RPC command gets the status of a specific invoice, if
|
|
it exists, or the status of all invoices if given no argument.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
On success, an array 'invoices' of objects is returned. Each object contains 'label', 'payment_hash', 'status' (one of 'unpaid', 'paid' or 'expired'), and 'expiry_time' (a UNIX timestamp). If the 'msatoshi' argument to lightning-invoice(7) was not "any", there will be an 'msatoshi' field. If the invoice 'status' is 'paid', there will be a 'pay_index' field and an 'msatoshi_received' field (which may be slightly greater than 'msatoshi' as some overpaying is permitted to allow clients to obscure payment paths).
|
|
|
|
//FIXME:Enumerate errors
|
|
|
|
AUTHOR
|
|
------
|
|
Rusty Russell <rusty@rustcorp.com.au> is mainly responsible.
|
|
|
|
SEE ALSO
|
|
--------
|
|
lightning-waitinvoice(7), lightning-delinvoice(7), lightning-invoice(7).
|
|
|
|
RESOURCES
|
|
---------
|
|
Main web site: https://github.com/ElementsProject/lightning
|
|
|