lightning-listoffers -- Command for listing offers
listoffers [offer_id] [active_only]
The listoffers RPC command list all offers, or with
offer_id, only the offer with that offer_id (if it
exists).
- offer_id (hash, optional): Offer_id to get details for (if it
exists).
- active_only (boolean, optional): If set and is true, only offers
with active true are returned.
On success, an object containing offers is returned. It is
an array of objects, where each object contains:
- offer_id (hash): The id of this offer (merkle hash of non-signature
fields).
- active (boolean): Whether this can still be used.
- single_use (boolean): Whether this expires as soon as it's paid.
- bolt12 (string): The bolt12 encoding of the offer.
- used (boolean): True if an associated invoice has been paid.
- label (string, optional): The (optional) user-specified label.
lightning-offer(7), lightning-listoffers(7)
Example 1:
Request:
$ lightning-cli listoffers -k "active_only"=True
{
"id": "example:listoffers#1",
"method": "listoffers",
"params": {
"active_only": true
}
}
Response:
{
"offers": [
{
"offer_id": "offeridl21000002100000210000021000002100000210000021000002100000",
"active": true,
"single_use": false,
"bolt12": "lno1qgsq000bolt210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000210002100021000",
"used": false
},
{
"offer_id": "offeridl22000002200000220000022000002200000220000022000002200000",
"active": true,
"single_use": false,
"bolt12": "lno1qgsq000bolt220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000220002200022000",
"used": false
},
{
"offer_id": "offeridl23000002300000230000023000002300000230000023000002300000",
"active": true,
"single_use": false,
"bolt12": "lno1qgsq000bolt230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000",
"used": false
}
]
}
Example 2:
Request:
$ lightning-cli listoffers "offeridl23000002300000230000023000002300000230000023000002300000"
{
"id": "example:listoffers#2",
"method": "listoffers",
"params": [
"offeridl23000002300000230000023000002300000230000023000002300000"
]
}
Response:
{
"offers": [
{
"offer_id": "offeridl23000002300000230000023000002300000230000023000002300000",
"active": true,
"single_use": false,
"bolt12": "lno1qgsq000bolt230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000230002300023000",
"used": false
}
]
}