mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-19 18:11:28 +01:00
49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
|
LIGHTNING-LISTINVOICES(7) Manual Page
|
||
|
|
=====================================
|
||
|
|
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>
|
||
|
|
|
||
|
|
------------------------------------------------------------------------
|
||
|
|
|
||
|
|
Last updated 2019-04-30 17:12:10 CEST
|