Pagination

By default, Fintoc returns 30 elements per paginated response, such as responses from List movements. The API includes pagination details in the Link header, following the RFC 8288 standard. The Link header is unrelated to Fintoc Link objects. For each paginated request, the API returns the pagination information using the Link header. This header contains one or more URLs that direct to different pages.

Pagination v1

Endpoints in the /v1 namespace, such as List links, use offset pagination. The Link header in this namespace lets you navigate to the next, previous, first, and last page:

Link Header

Link: <https://api.fintoc.com/v1/links?page=1>; rel="first",
  <https://api.fintoc.com/v1/links?page=2>; rel="next"

The possible rel values are:

Name	Description
`next`	Link that leads to the next page of the resource
`last`	Link that leads to the last page of the resource
`first`	Link that leads to the first page of the resource
`prev`	Link that leads to the previous page of the resource

Pagination in V2

Endpoints in the /v2 namespace, such as List Transfers, use cursor-based pagination. In this namespace, the Link header only allows navigation to the next page in the list:

Link Header

Link: <https://api.fintoc.com/v2/transfers?starting_after=tr_12334567>; rel="next"

The possible rel values are:

Name	Description
`next`	Link that leads to the next page of the resource

If Link is empty, it means there are no more pages.

Automatic pagination

The Node SDK and Python SDK support automatic pagination. This feature allows you to iterate through large lists of resources without having to manually perform the requests to fetch subsequent pages:

Node

import { Fintoc } from 'fintoc';

const client = new Fintoc('your_api_key');

const paymentIntents = await client.paymentIntents.list();
for await (const paymentIntent of paymentIntents) {
  // Do something with the paymentIntent
}

Python

from fintoc import Fintoc

client = Fintoc("your_api_key")

payment_intents = client.payment_intents.all()
for payment_intent in payment_intents:
    # Do something with the payment intent

Other libraries

If you use other languages or don’t want to use our SDK, the following libraries parse the Link header so that you don’t have to:

Language	Library
Python	`requests`
Ruby	`Nitlink`
JavaScript	`parse-link-header`

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

Other libraries

​Pagination v1

​Pagination in V2

​Automatic pagination

​Other libraries

Pagination v1

Pagination in V2

Automatic pagination

Other libraries