A Link is a set of credentials associated to an end-user's access to an institution.

Example: The username and password combination used to log in to an online banking application would be a link.

You will need to register a Link before accessing information from that specific end-user, such as account or transaction details.

Note: We recommend using our Connect Widget to handle link creation and link status updates.

You have the possibility to register two types of links:

Recurrent links (default)

With recurrent links, Belvo automatically refreshes information weekly and notifies you via Webhooks so you always have up-to-date data. Then, when you receive the webhook, you can make GET requests to the List or Detail endpoints to instantly access up-to-date information, without needing to connect to the institution.


You can also make POST calls directly to the institution, as with single links, as soon as the link is created. However, we recommend you follow the flow described above (waiting for the webhook event) for a more optimal experience.

Single links

Single links are used to perform ad hoc data access to accounts, owners, transactions, and so on. For example, you can use it when you want to do an underwriting process to assess risk before lending money.

For single links, you have to perform POST calls to an institution every time you want to access fresh data.