Recurring expense insights.
ℹ️ If no recurring expense insights are found, we return an empty array.
Belvo's unique identifier for the current item.
Details regarding the account.
Note: For our recurring expenses resource, this account relates to the account that was analyzed to generate the recurring expenses report.
Belvo's unique identifier for the current item.
The link.id
the data belongs to.
The ISO-8601 timestamp when the data point was collected.
The ISO-8601 timestamp of when the data point was created in Belvo's database.
The type of account. We return one of the following enum values:
CHECKING_ACCOUNT
CREDIT_CARD
INVESTMENT_ACCOUNT
LOAN_ACCOUNT
PENSION_FUND_ACCOUNT
SAVINGS_ACCOUNT
UNCATEGORIZED
null
Indicates whether this account is either an ASSET
or a LIABILITY
. You can consider the balance of an ASSET
as being positive, while the balance of a LIABILITY
as negative.
The account type, as designated by the institution.
The account name, as given by the institution.
The account number, as designated by the institution.
Details regarding the current and available balances for the account.
The current balance is calculated differently according to the type of account.
- 💰 Checking and saving accounts:
The user's account balance at the collected_at
timestamp.
- 💳 Credit cards:
The amount the user has spent in the current card billing period (see credit_data.cutting_date
for information on when the current billing period finishes).
- 🏡 Loan accounts:
The amount remaining to pay on the users's loan.
The balance that the account owner can use.
- 💰 Checking and saving accounts:
The available balance may be different to the current
balance due to pending transactions.
- 💳 Credit cards:
The credit amount the user still has available for the current period. The available
balance may be different to the current
balance due to pending transactions or future instalments.
- 🏡 Loan accounts:
The present value required to pay off the loan, as provided by the institution.
Note: If the institution does not provide this value, we return null
.
The currency of the account. For example:
- 🇧🇷 BRL (Brazilian Real)
- 🇨🇴 COP (Colombian Peso)
- 🇲🇽 MXN (Mexican Peso)
Please note that other currencies other than in the list above may be returned.
The public name for the type of identification. For example: "CLABE"
.
ℹ️ For 🇧🇷 Brazilian savings and checking accounts, this field will be AGENCY/ACCOUNT
.
The value for the public_identification_name
.
ℹ️ For 🇧🇷 Brazilian savings and checking accounts, this field will be the agency and bank account number, separated by a slash. For example: 0444/45722-0
.
The ISO-8601 timestamp of Belvo's most recent successful access to the institution for the given link.
The credit options associated with this account.
The maximum amount of credit the owner can receive.
The ISO-8601 timestamp when the data point was collected.
The closing date of the credit period, in YYYY-MM-DD
format.
The due date for the next payment , in YYYY-MM-DD
format.
The minimum amount to be paid on the next_payment_date
.
The minimum amount required to pay to avoid generating interest.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The recurrent monthly payment, if applicable.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The date when the last credit payment was made, in YYYY-MM-DD
format.
The loan options associated with this account.
The ISO-8601 timestamp when the data point was collected.
The initial total loan amount, calculated by the institution, when the contract was signed. This amount includes the principal + interest + taxes + fees.
Total amount of the loan (the amount the user receives).
The day of the month by which the owner needs to pay the loan (DD
).
Outstanding loan amount, that is, how much remains to pay on the principal (not including interest).
The amount remaining to pay in total, including interest.
The recurrent monthly payment, if applicable.
Breakdown of the interest applied to the loan.
The name of the type of interest rate applied to the loan.
The period that the interest is applied to the loan. We return one of the following values:
MONTHLY
YEARLY
The total number of installments required to pay the loan.
The number of installments left to pay.
The date when the loan contract was signed , in YYYY-MM-DD
format.
The date when the loan is expected to be completed, in YYYY-MM-DD
format.
The contract number of the loan, as given by the institution.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
Please see principal
instead.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
Please see outstanding_balance
instead.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
Please see the interest_rates
object instead.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
Please see payment_day
instead.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The closing day of the month for the loan.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The closing date of the loan period, in YYYY-MM-DD
format.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The date when the last loan payment was made, in YYYY-MM-DD
format.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
Please use payment_day
instead, in YYYY-MM-DD
format.
This field has been deprecated. For more information regarding Belvo and deprecation, see our Deprecated fields explanation.
The institution's product ID for the account type.
The name for the recurring expense.
ℹ️ Note: This information is taken from the description section of a transaction and then normalized to provide you with an easy-to-read name. As such, sometimes the name will reflect the merchant the payment is made to (for example, Netflix.com), while for other recurring expenses, this could be something like "Monthly payment to John".
An array of minified transaction objects used to evaluate the recurring expense. If no transactions were found, we return an empty array.
The description of the transaction provided by the institution. Usually, this is the text that the end user would see in the bank statement. The description can be an empty string.
Note: For EYOD Risk Insights, the description is the one that you provided in the initial request.
The frequency at which this recurring expense occurs.
ℹ️ Note: Belvo only identifies MONTHLY
frequencies.
The average transaction amount of the recurring expense.
The median transaction amount of the recurring expense.
Number of days since the last recurring expense occurred.
Based on the frequency, you can infer how many days until the next charge will occur.
The transaction category for the recurring expense. For more information on the available categories, please see our Transaction categorization documentation.
Online Platforms & Leisure
(Netflix, Spotify, Gym Memberships)Bills & Utilities
(electricity, telephone, internet)Credits & Loans
(credit card cash advances, student loan, watercraft lease)Insurance
(home, car, and health & life insurance)Transport & Travel
(Uber trip, airbnb, parking)Taxes
(service fee, donation, court taxes)
{ "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "account": { "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d", "link": "30cb4806-6e00-48a4-91c9-ca55968576c8", "institution": { … }, "collected_at": "2022-02-09T08:45:50.406032Z", "created_at": "2022-02-09T08:45:50.406032Z", "category": "CHECKING_ACCOUNT", "balance_type": "ASSET", "type": "Cuentas de efectivo", "name": "Cuenta Perfiles- M.N. - MXN-666", "number": "4057068115181", "balance": { … }, "currency": "MXN", "public_identification_name": "CLABE", "public_identification_value": "150194683119900273", "last_accessed_at": "2021-03-09T10:28:40.000Z", "credit_data": { … }, "loan_data": { … }, "funds_data": [ … ], "bank_product_id": null, "internal_identification": null }, "name": "Netflix", "transactions": [ { … } ], "frequency": "MONTHLY", "average_transaction_amount": 32.9, "median_transaction_amount": 32.9, "days_since_last_transaction": 5, "category": "Online Platforms & Leisure", "payment_type": "SUBSCRIPTION" }