Enrichment (Updated 🎉 )

Combine data aggregation with our enrichment product to get easy-to-use insights about your users.

Income verification

📘

The Incomes resource is only available for Checking Accounts associated with banking links.

Our Incomes endpoint provides you with information regarding the income sources of a banking link.

Use the Incomes endpoint to gather insights on an account's income sources for the past 365 days. The endpoint is particularly useful when you want to verify a person's income.

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

  • income source and confidence
  • list of transactions used to determine the income source

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

Endpoints

Method

Description

Retrieve

POST

Retrieve income insights from a specific link. The period is up to 365 days and depends on the transaction history available for each bank.

List

GET

List the incomes associated with your Belvo account.

Resume

PATCH

Resume an Incomes retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a specific income.

Destroy

DELETE

Delete a specific income from your Belvo account.

Recurring expenses

🎉 In Beta
This resource is currently in open beta for all users. If you see any issues, don't hesitate to contact our support team.

Belvo's Recurring Expenses endpoint allows you to identify a user's regular payments for subscription services, such as Netflix or gym memberships, as well as utility payments, such as electricity or phone bills. We return information for up to 365 days.

📘

The recurring expenses resource is only available for Checking and Savings accounts associated with banking links.

Endpoints

Method

Description

Retrieve

POST

Retrieve recurring expense insights from a specific link. The period is up to 365 days and depends on the transaction history available for each bank.

List

GET

List the recurring expense associated with your Belvo account.

Resume

PATCH

Resume a recurring expense retrieve session that was paused because an MFA token was required by the institution.

Detail

GET

Get the details of a recurring expense.

Destroy

DELETE

Delete a specific recurring expense from your Belvo account.

Risk insights

🎉 In Beta
This resource is currently in open beta for all users. If you see any issues, don't hesitate to contact our support team.

Belvo's Risk Insights endpoint exposes a set of features that can be used to improve your company's credit risk and opportunity decisions. This set of features can be used as building blocks to create or iterate on your own credit score using transactional banking data with the objective of improving the predictive power of your models. You can use these components as you require and according to what makes the most sense for your specific use case.

To calculate the risk insights, we take up to 90 days of transactional data from the user's checking, savings, loans, and credit card accounts.

EndpointsMethodDescription
RetrievePOSTRetrieve risk insights for a specific link. The period is up to 90 days and depends on the transaction history available for each bank.
ListGETList all the risk insight analyses associated with your Belvo account.
ResumePATCHResume a risk insights retrieve session that was paused because an MFA token was required by the institution.
DetailGETGet the details of a risk insight analysis.
DestroyDELETEDelete a specific risk insight analysis from your Belvo account.

Did this page help you?