Accounts
Our Accounts endpoint provides you with information regarding the gig account in a gig economy institution. Usually, an end user has just one Account inside each gig link.
Use this endpoint to get information about a gig 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 all accounts related to a specific link. | |
| List all the accounts from all the Links already associated with your Belvo account. | |
| Resume an Account Retrieve session that was paused because an MFA token was required by the institution. | |
| Get the details of a specific account. | |
| Delete a specific account and all associated transactions from your Belvo API key. |
Owners
Our Owners endpoint provides you information regarding the person who is the owner of each account within the gig 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 the owner detail of a specific link. | |
| List all owners associated to your Belvo account. | |
| Resume an Owner Retrieve session that was paused because an MFA token was required by the institution. | |
| Get the details of a specific owner. | |
| Delete a specific owner 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 gig 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 all transactions related to a specific account within a data range. | |
| List all the transactions from all Links you have access to. | |
| Resume a Transaction Retrieve session that was paused because an MFA token was required by the institution. | |
| Get the details of a specific transaction, using the transaction ID. | |
| 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" |
Updated 3 months ago