core-lightning/doc/lightning-listinvoices.7.md
Christian Decker c3254e6639 docs: Update manpages to be recognized correctly by mrkd
mrkd started enforcing the `name -- short description` style of top-level
headings somewhere, and was thus failing to build the man-pages. I swapped
the title and with the existing short description to make it work
again. `mrkd` will automatically infer the section from the filename so no
need to put it in the title as well.

In addition I removed the "last updated" lines at the bottom since they are
out of date at best, and misleading at the worst. If we want to keep them, I'd
suggest generating them from the commit that last touched them.
2019-09-02 16:31:36 +02:00

1.3 KiB

lightning-listinvoices -- Command 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 as a number, and amount_msat as the same number ending in msat. 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); there will also be an amount_received_msat field with the same number as msatoshi_received but ending in msat.

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