Get invoices
GET/api/v1/stores/:storeId/invoices
Returns a list of all invoices for the given store, ordered by creation date (newest first).
You can filter results by date using startDate and endDate query parameters.
Both accept an ISO 8601 date string (2024-01-15) or a Unix timestamp in seconds or milliseconds.
Invoice statuses
| Status | Meaning |
|---|---|
New | Invoice created, awaiting payment |
Processing | Payment received. Lightning invoices move to Settled immediately; Bitcoin on-chain stays here until the transaction is confirmed |
Settled | Payment confirmed and deposit to your wallet is being processed |
Expired | Payment window closed without receiving the full amount. May have additionalStatus: Underpaid if a partial payment arrived |
Invalid | Invoice was invalidated by the payment network (e.g. double-spend detected) |
Request
Responses
- 200
- 400
- 401
- 404
- 500
Successfully retrieved the invoices
Bad request. Invalid input parameters.
Unauthorized.
No invoices found.
Unexpected error.