Skip to main content
GET
List invoices

Authorizations

Authorization
string
header
required

API key prefixed with finta_

Query Parameters

limit
integer
default:100

Maximum number of results to return (1-500). Defaults to 100.

Required range: 1 <= x <= 500
starting_after
string

A cursor for pagination. Pass the next_cursor value from a previous response to fetch the next page.

status
enum<string>

Only invoices with this status. If omitted, returns invoices of every status.

Available options:
open,
paid,
voided
customer
string

Case-insensitive text search on the customer name.

amount_cents
integer

Only invoices whose total amount_cents is exactly this value.

start_date
string<date>

Only invoices dated on or after this date (YYYY-MM-DD).

end_date
string<date>

Only invoices dated on or before this date (YYYY-MM-DD).

paid_transaction_id
string

Only the invoice paid by this transaction. An unknown transaction returns an empty list.

Pattern: ^txn_

Response

A paginated list of invoices

object
enum<string>
required
Available options:
list
url
string
required
Example:

"/api/v1/invoices"

has_more
boolean
required

Whether there are more results beyond this page.

next_cursor
string | null
required

Pass this value as starting_after to fetch the next page. Null when has_more is false.

data
object[]
required