List invoices
Lists the invoices of your organization for the live or test mode of the API key used, sorted by creation date with the most recent first. Use subscription to narrow the list to the invoices generated by a single subscription, and the cursor parameters to paginate through the results.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Query Parameters
id of a subscription. If present, the response contains only the invoices generated by that subscription.
"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"
Maximum number of invoices to return per page, between 1 and 300. Defaults to 30.
Cursor for pagination. An invoice id that defines your place in the list: the response contains the invoices that come after that invoice. Cannot be combined with ending_before.
"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
Cursor for pagination. An invoice id that defines your place in the list: the response contains the invoices that come before that invoice. Cannot be combined with starting_after.
"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
Response
List of invoices for the current mode. The Link response header contains the URL of the next page, when there is one.
Unique identifier of the invoice.
"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
URL of the hosted invoice page, where your customer can view and pay the invoice. null for test mode invoices and for invoices that are not open.
"https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
Type of the object. Always invoice.
Number of automatic charge attempts Fintoc has made on the invoice. 0 until the invoice is finalized and charged for the first time.
1
ISO 8601 timestamp of when the invoice was created.
"2026-05-01T12:00:00Z"
Currency of the invoice, as an ISO 4217 code. Every line item uses this currency.
CLP, MXN "CLP"
id of the customer the invoice bills.
"cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo"
id of the payment method Fintoc charges when the invoice is finalized. null for invoices without one, such as subscription invoices.
"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"
Line items that make up the invoice total.
Set of key-value pairs attached to the invoice. null when the invoice has no metadata.
Mode of the invoice. live invoices use real data; test invoices use fake data for integration testing. An API key only sees invoices that share its mode.
live, test "live"
ISO 8601 timestamp of the next scheduled automatic charge attempt. null when no further attempt is scheduled.
"2026-05-02T12:00:00Z"
Payment attempts to collect the invoice.
Status of the invoice. Invoices start as draft, become open when finalized, and end as paid or void.
draft, open, paid, void "draft"
id of the subscription that generated the invoice. null for invoices not tied to a subscription.
"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"
Total amount of the invoice, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Equals the sum of the line item amounts.
30000