Banking

Our Banking product to lets you access account, balance, income, owner, and transaction data to get a comprehensive view of your end user.

We refer to links created with banking institutions (such as Santander or Bradesco) as banking links.

❗️

Business banks and additional requests

With business or commercial banks that require MFA, you can access data for up to 30 minutes after a user provides their authentication token.

In other words, after a user provides their authentication token to, for example, connect their account, you can make POST calls to the institution for up to 30 minutes before needing to request a new authentication token.

Accounts

Our Accounts endpoint provides you with information regarding the bank account in a financial institution. An end user can have several Accounts inside each Link. For example, one Link can have one checking account, several credit cards, and even loan or investment accounts.

Use this endpoint to get information about a banking link's:

  • account type and category
  • current account balance
  • account currency
  • and so much more

We offer the following methods when it comes to interacting with Accounts:

Endpoints

Method

Description

Retrieve

POST

Retrieve all accounts related to a specific link.

List

GET

List all the accounts from all the Links already associated with your Belvo account.

Resume

PATCH

Resume an Account Retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a specific account.

Destroy

DELETE

Delete a specific account and all associated transactions from your Belvo API key.

Balances

Our Balances endpoint provides you with the financial status of an Link's account at a given time.

Use this endpoint to get information about a banking link's:

  • daily account balance over a period of time

We offer the following methods when it comes to interacting with Balances:

Endpoints

Method

Description

Retrieve

POST

Retrieve balances from a specific account or all accounts from a specific link. You can retrieve the balances at the end of the day for all accounts between two dates.

List

GET

List all existing balances in your Belvo account.

Resume

PATCH

Resume a Balance Retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a specific balance.

Destroy

DELETE

Delete a specific balance from your Belvo account.

Owners

Our Owners endpoint provides you information regarding the person who is the owner of each account within a Link.

Use this endpoint to get information about a link owner's:

  • full name
  • phone number
  • mailing address
  • email address

We offer the following methods when it comes to interacting with Owners:

Endpoints

Method

Description

Retrieve

POST

Retrieve the owner detail of a specific link.

List

GET

List all owners associated to your Belvo account.

Resume

PATCH

Resume an Owner Retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a specific owner.

Destroy

DELETE

Delete a specific owner from your Belvo account.

Statements (BETA)

Our Statements endpoint lets you get a summary of an Account's monthly transactions.

Use this endpoint to get information for a given month about a link's:

  • total transactions (inflow and outflow)
  • total transaction amount (inflow and outflow)
  • start and end balance

📘

Statements BETA

Please note that the Statements endpoint is currently in BETA and only available for institutions in Mexico 🇲🇽.

We offer the following methods when it comes to interacting with Statements:

Endpoint

Method

Description

Retrieve

POST

Retrieve a statement for a specific month and year.

List

GET

List all the generated statements for the links you have access to.

Resume

PATCH

Resume a statement Retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get details for a specific statement.

Destroy

DELETE

Delete a specific statement from your Belvo account.

Transactions

Our Transactions endpoint provides you with detailed transactional information for an end user.

Use this endpoint to get information about a link's:

  • transaction history
  • the category for each transaction
  • the status of each transaction

We offer the following methods when it comes to interacting with Transactions:

Endpoints

Method

Description

Retrieve

POST

Retrieve all transactions related to a specific account within a data range.

List

GET

List all the transactions from all Links you have access to.

Resume

PATCH

Resume a Transaction Retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a specific transaction, using the transaction ID.

Destroy

DELETE

Delete a specific transaction from your Belvo account.

Transaction categorization

Using a combination of internal and external data sources, we provide a clean and standardized category for most transactions.
A category is automatically assigned to each transaction as soon as it is retrieved from the bank.

Here is the list of transaction categories we support:

Category

Example of transaction

Deposits

"DEPOSITO INTERBANCARIO"

Home & Life

"ELEKTRA MEXIC"

Food & Groceries

"OXXO CIPRESES"

Online Platforms & Leisure

"NETFLIX COM CR"

Transport & Travel

"UBER TRIP HELP.UBER.COM"

Personal Shopping

"LIVERPOOL POR INTERNET"

Taxes

"IVA COM MEMBRESIA"

Withdrawal & ATM

"RETIRO CAJERO AUTOMATICO"

Credits & Loans

"ABONO A CREDITO GLOBAL"

Bills & Utilities

"HT TELCEL 018008"

Investments & Savings

"ABONO INTERESES AHORROS"

Fees & Charges

"COMISION EMISION"

Income & Payments

"PAGO DE NOMINA"

Transfers

"SPEI RECIBIDOSTP"


Did this page help you?