Skip to main content
Use this endpoint to retrieve invoices previously created in your Finrock sub-account. You can fetch all invoices or narrow the results by providing a specific invoice ID or a memo string to match. This is useful for reconciling payments, checking invoice status, and building invoice management workflows in your application.

​
Request

Method: POST URL: https://api.finrock.io/dac/v1/invoices
​
string
The unique identifier of the invoice you want to retrieve. When provided, the response contains only the matching invoice.
​
string
Filter invoices by memo text. Returns all invoices whose memo field matches or contains the provided string.

​
Example Requests

​
Response

A 200 response returns an array of invoice objects matching your filter criteria. When no filters are provided, all invoices in your sub-account are returned. A 400 response indicates an issue with the request body.
​
array
An array of invoice objects, each containing the invoice ID, payment address, crypto and fiat amounts, memo, payer details, status, and expiry.
​
object
Returned when the request body is malformed or contains invalid filter values.
To retrieve a single invoice by ID, pass only the id field. To browse all invoices for reconciliation, omit both fields and paginate through the full result set.