# Listar despesas recorrentes

## ▶️ Uso

Com o método Listar Despesas Recorrentes, você pode:

1. Listar despesas recorrentes relacionadas a um link.id específico (usando o parâmetro de consulta link).
2. Obter os detalhes de um recurring-expense.id específico (usando o parâmetro de consulta id).
3. [Não Recomendado] Listar todas as despesas recorrentes relacionadas à sua conta Belvo (sem usar nenhum parâmetro de consulta).

## 📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, consulte nosso artigo Dicas de Paginação.

## 🔦 Filtrando Respostas

Consulte a lista de consultas abaixo para ver uma lista de campos pelos quais você pode filtrar suas respostas. Para mais informações sobre como usar filtros, consulte nosso artigo Filtrando respostas.

Endpoint: GET /api/recurring-expenses/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `link` (string)
    O link.id pelo qual você deseja filtrar.

ℹ️ Recomendamos fortemente adicionar o filtro link.id para melhorar seu desempenho.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indica quantos resultados retornar por página. Por padrão, retornamos 100 resultados por página.

ℹ️ O número mínimo de resultados retornados por página é 1 e o máximo é 1000. Se você inserir um valor maior que 1000, nossa API usará o valor máximo por padrão (1000).
    Example: 100

  - `page` (integer)
    Um número de página dentro do conjunto de resultados paginados.
    Example: 1

  - `omit` (string)
    Omitir certos campos de serem retornados na resposta. Para mais informações, consulte nosso artigo Filtrando respostas no DevPortal.

  - `fields` (string)
    Retorne apenas os campos especificados na resposta. Para mais informações, consulte nosso artigo no DevPortal Filtrando respostas.

  - `link__in` (array)
    Retorne resultados apenas para esses link.ids.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `account` (string)
    O account.id pelo qual você deseja filtrar.

ℹ️ Recomendamos fortemente adicionar os filtros link.id ou account.id para melhorar seu desempenho.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `account__in` (array)
    Retorne resultados apenas para esses account.ids.
    Example: ["85b77707-90ef-46fd-9059-5a757f24247a"]

  - `id` (string)
    Retorne informações apenas para este recurso id.
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Retorne informações para esses ids de recurso.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

## Response 200 fields (application/json):

  - `count` (integer)
    O número total de resultados na sua conta Belvo.
    Example: 130

  - `next` (string,null)
    A URL para a próxima página de resultados. Cada página consiste em até 100 itens. Se não houver resultados suficientes para uma página adicional, o valor será null.

Em nosso exemplo de documentação, usamos {endpoint} como um valor de espaço reservado. Em produção, esse valor será substituído pelo endpoint real que você está usando atualmente (por exemplo, accounts ou owners).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908&page=2"

  - `previous` (string,null)
    A URL para a página anterior de resultados. Se não houver uma página anterior, o valor será null.

  - `results` (array)
    Array de objetos de despesas recorrentes.

  - `results.id` (string)
    Identificador único da Belvo para o item atual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.account` (object,null, required)
    Detalhes sobre a conta.

  - `results.account.id` (string, required)
    Identificador único da Belvo para o item atual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.account.link` (string,null, required)
    O link.id ao qual os dados pertencem.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `results.account.institution` (object, required)
    Detalhes sobre a instituição.

  - `results.account.institution.name` (string)
    O nome da instituição, conforme designado pela Belvo.
    Example: "erebor_mx_retail"

  - `results.account.institution.type` (string)
    O tipo de instituição. Retornamos um dos seguintes valores:

  - bank
  - fiscal
  - employment
    Enum: "bank", "fiscal", "employment"

  - `results.account.collected_at` (string, required)
    O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.created_at` (string, required)
    O carimbo de data e hora ISO-8601 de quando o ponto de dados foi criado no banco de dados da Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.last_accessed_at` (string,null, required)
    O timestamp ISO-8601 do acesso mais recente e bem-sucedido da Belvo à instituição para o link fornecido.
    Example: "2021-03-09T10:28:40.000Z"

  - `results.account.category` (string,null, required)
    O tipo de conta.  
Retornamos um dos seguintes valores do enum:  
  - ADVANCE_DEPOSIT_ACCOUNT
  - CHECKING_ACCOUNT
  - CREDIT_CARD
  - FINANCING_ACCOUNT
  - INVESTMENT_ACCOUNT
  - INVOICE_FINANCING_ACCOUNT
  - LOAN_ACCOUNT
  - PENSION_FUND_ACCOUNT
  - SAVINGS_ACCOUNT
  - UNCATEGORIZED
    Enum: "ADVANCE_DEPOSIT_ACCOUNT", "CHECKING_ACCOUNT", "CREDIT_CARD", "FINANCING_ACCOUNT", "INVESTMENT_ACCOUNT", "INVOICE_FINANCING_ACCOUNT", "LOAN_ACCOUNT", "PENSION_FUND_ACCOUNT", "SAVINGS_ACCOUNT", "UNCATEGORIZED"

  - `results.account.balance_type` (string,null, required)
    Indica se esta conta é um ASSET ou um LIABILITY. Você pode considerar o saldo de um ASSET como positivo, enquanto o saldo de um LIABILITY como negativo.
    Example: "ASSET"

  - `results.account.overdraft` (object,null)

  - `results.account.overdraft.arranged` (number, required)
    O limite de cheque especial acordado entre o titular da conta e a instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo overdraft estiver disponível.
    Example: 5000.5

  - `results.account.overdraft.used` (number, required)
    O valor do cheque especial utilizado.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo overdraft estiver disponível.
    Example: 1000.5

  - `results.account.overdraft.unarranged` (number, required)
    O cheque especial utilizado que não foi acordado entre o titular da conta e a instituição.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil se o campo overdraft estiver disponível.
    Example: 300.1

  - `results.account.type` (string, required)
    O tipo de conta, conforme designado pela instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "STANDARD_NACIONAL"

  - `results.account.subtype` (string, required)
    O subtipo de conta, conforme designado pela instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "FINANCIAMENTO_HABITACIONAL_SFH"

  - `results.account.name` (string,null, required)
    O nome da conta, conforme fornecido pela instituição.
    Example: "Cuenta Perfiles- M.N. - MXN-666"

  - `results.account.number` (string,null, required)
    O número da conta, conforme designado pela instituição.
    Example: "4057068115181"

  - `results.account.agency` (string,null, required)
    O código da agência onde o produto foi aberto.
    Example: "6272"

  - `results.account.check_digit` (string,null, required)
    O dígito verificador do número do produto, se aplicável.
    Example: "7"

  - `results.account.balance` (object, required)
    Detalhes sobre os saldos atual e disponível para a conta.

  - `results.account.balance.current` (number,null, required)
    O saldo atual é calculado de maneira diferente de acordo com o tipo de conta.

- 💰 Contas correntes e poupança:

O saldo da conta do usuário no timestamp collected_at.

- 💳 Cartões de crédito:

O valor que o usuário gastou no período de faturamento atual do cartão (consulte credit_data.cutting_date para informações sobre quando o período de faturamento atual termina).

- 🏡 Contas de empréstimo:

O valor restante a pagar no empréstimo do usuário.
    Example: 5874.13

  - `results.account.balance.available` (number,null)
    O saldo que o titular da conta pode usar.

- 💰 Contas correntes e poupança:

O saldo disponível pode ser diferente do saldo current devido a transações pendentes.

- 💳 Cartões de crédito:

O valor de crédito que o usuário ainda tem disponível para o período atual. O valor é calculado como credit_data.credit_limit menos balance.current.

- 🏡 Contas de empréstimo:

O valor presente necessário para quitar o empréstimo, conforme fornecido pela instituição.

Nota: Se a instituição não fornecer esse valor, retornamos null.
    Example: 5621.12

  - `results.account.balance.blocked` (number)
    O valor que está atualmente bloqueado devido a transações pendentes.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.
    Example: 60.32

  - `results.account.balance.automatically_invested` (number)
    O valor que é automaticamente investido (conforme acordado com a instituição).

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.
    Example: 131.5

  - `results.account.reserved_balances` (array, required)
    The account's reserves (for example, caixinhas or cofrinhos): money the account holder has set aside inside the account, with or without yield. Reserves that are investments registered to the account holder are not included here and are returned by the investments endpoints instead.

Reserved amounts are not included in balance.current, balance.available or balance.automatically_invested.

Always returned. Reserves only exist on checking, savings and prepaid payment accounts, so this field is always an empty list ([]) for other accounts, such as credit cards and loans. For checking, savings and prepaid payment accounts, an empty list means that the institution reported no reserves for the account, or that they could not be retrieved.

  - `results.account.reserved_balances.name` (string,null)
    The name the account holder gave to the reserve.
    Example: "Cofrinho"

  - `results.account.reserved_balances.identification` (string,null)
    The institution's unique identifier for the reserve.
    Example: "d78fc4e5-37ca-4da3-adf2-9b082bf92280"

  - `results.account.reserved_balances.amounts` (array,null)
    The amounts held in the reserve. Usually a single BRL amount.

  - `results.account.reserved_balances.amounts.amount` (number,null)
    The amount available in the reserve.
    Example: 1565.51

  - `results.account.reserved_balances.amounts.currency` (string,null)
    O código de moeda de três letras (ISO-4217).
    Example: "BRL"

  - `results.account.reserved_balances.amounts.remuneration` (object,null)
    The yield applied to the reserved amount, as reported by the institution. null when the reserve has no yield.

  - `results.account.reserved_balances.amounts.remuneration.pre_fixed_rate` (number,null)
    The pre-fixed rate applied to the reserve, expressed as a decimal (for example, 0.145 represents 14.5%).

Returned when post_fixed_rate is not.

  - `results.account.reserved_balances.amounts.remuneration.post_fixed_rate` (number,null)
    The percentage of the indexer applied to the reserve, expressed as a decimal (for example, 1.2 represents 120% of the CDI).

Returned when pre_fixed_rate is not.
    Example: 1.2

  - `results.account.reserved_balances.amounts.remuneration.rate_type` (string,null)
    The type of remuneration rate. Can be either:
  - LINEAR
  - EXPONENCIAL
    Example: "LINEAR"

  - `results.account.reserved_balances.amounts.remuneration.rate_periodicity` (string,null)
    The frequency that the remuneration rate is applied. Can be either:
  - DIARIO
  - MENSAL
  - ANUAL
  - SEMESTRAL
    Example: "ANUAL"

  - `results.account.reserved_balances.amounts.remuneration.calculation_base` (string,null)
    Indicates whether the remuneration is calculated over business days (dias úteis) or calendar days (dias corridos). Can be either:
  - DIAS_UTEIS
  - DIAS_CORRIDOS
    Example: "DIAS_UTEIS"

  - `results.account.reserved_balances.amounts.remuneration.indexer` (string,null)
    The index used as a reference for the remuneration. Can be either:
  - CDI
  - DI
  - TR
  - IPCA
  - IGP_M
  - IGP_DI
  - INPC
  - BCP
  - TLC
  - SELIC
  - PRE_FIXADO
  - OUTROS
    Example: "CDI"

  - `results.account.reserved_balances.amounts.remuneration.indexer_additional_info` (string,null)
    Additional information about the indexer. Returned when indexer is OUTROS.

  - `results.account.currency` (string, required)
    O código de moeda de três letras (ISO-4217).

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.
    Example: "BRL"

  - `results.account.public_identification_name` (string,null, required)
    O nome público para o tipo de identificação. Para contas de poupança e corrente brasileiras 🇧🇷, este campo será AGENCY/ACCOUNT.
    Example: "AGENCY/ACCOUNT"

  - `results.account.public_identification_value` (string,null, required)
    O valor para o public_identification_name.

Para contas de poupança e corrente 🇧🇷 OFDA brasileiras, este campo será o número da agência e da conta bancária, separados por uma barra. Por exemplo: 0444/45722-0.

Para contas de cartão de crédito 🇧🇷 OFDA brasileiras, retornaremos uma string de números de cartão de crédito concatenados associados à conta. Por exemplo: "8763,9076,5522"
    Example: "0444/45722-0"

  - `results.account.internal_identification` (string, required)
    A identificação interna da instituição para a conta.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo balances estiver disponível.
    Example: "92792126019929279212650822221989319252576"

  - `results.account.credit_data` (object,null, required)
    Detalhes sobre os cartões de crédito associados a esta conta.

  - `results.account.credit_data.collected_at` (string, required)
    O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.credit_data.credit_limit` (number,null, required)
    O limite de crédito superior do cartão.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: 192000.9

  - `results.account.credit_data.limits` (array)

  - `results.account.credit_data.limits.identification_number` (string,null, required)
    O número do cartão de crédito.

Nota: Frequentemente, são apenas os últimos quatro dígitos do cartão de crédito.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "4453"

  - `results.account.credit_data.limits.credit_limit` (number,null, required)
    O limite do cartão de crédito.
    Example: 1000.04

  - `results.account.credit_data.limits.used_amount` (number,null, required)
    A quantidade utilizada.
    Example: 400.04

  - `results.account.credit_data.limits.available_amount` (number, required)
    O valor ainda disponível.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: 600

  - `results.account.credit_data.limits.is_limit_flexible` (boolean, required)
    Boolean para indicar se o credit_limit é flexível.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

  - `results.account.credit_data.limits.type` (string, required)
    O tipo de limite. Retornamos um dos seguintes valores:

  - TOTAL_LIMIT
  - MODAL_LIMIT

  > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "TOTAL_LIMIT", "MODAL_LIMIT"

  - `results.account.credit_data.limits.consolidation_type` (string, required)
    Indica se o limite de crédito é consolidado ou individual.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "INDIVIDUAL"

  - `results.account.credit_data.limits.line_name` (string,null, required)
    O nome da linha de limite de crédito.
    Example: "CREDITO_A_VISTA"

  - `results.account.credit_data.limits.line_name_additional_info` (string,null, required)
    Informações adicionais sobre o nome da linha.
    Example: "Informações adicionais e complementares"

  - `results.account.credit_data.cutting_date` (string,null)
    A data de vencimento da fatura do cartão de crédito.
    Example: "2019-12-11"

  - `results.account.credit_data.minimum_payment` (number,null)
    O valor mínimo que o proprietário da conta precisa pagar no período de crédito atual.
    Example: 2400.3

  - `results.account.credit_data.network` (string)
    A rede de crédito à qual o cartão está associado. Retornamos um dos seguintes valores:

  - VISA
  - MASTERCARD
  - AMERICAN_EXPRESS
  - DINERS_CLUB
  - HIPERCARD
  - BANDEIRA_PROPRIA
  - CHEQUE_ELETRONICO
  - ELO
  - OTHER

  > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "VISA", "MASTERCARD", "AMERICAN_EXPRESS", "DINERS_CLUB", "HIPERCARD", "BANDEIRA_PROPRIA", "CHEQUE_ELETRONICO", "ELO", "OTHER"

  - `results.account.credit_data.network_additional_info` (string,null)
    Informações adicionais sobre a rede de cartão de crédito.
    Example: "It's an orange card."

  - `results.account.credit_data.cards` (array)
    Detalhes sobre os cartões associados à conta.

  - `results.account.credit_data.cards.is_multiple` (boolean, required)
    Boolean para indicar se esta conta possui múltiplos cartões de crédito.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.

  - `results.account.credit_data.cards.identification_number` (string, required)
    O número do cartão de crédito.

Nota: Frequentemente, são apenas os últimos quatro dígitos do cartão de crédito.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "4453"

  - `results.account.credit_data.next_payment_date` (string,null)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.credit_data.no_interest_payment` (number,null)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.credit_data.interest_rate` (number,null)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.credit_data.monthly_payment` (number,null)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.credit_data.last_payment_date` (string,null)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data` (object,null, required)
    As opções de empréstimo associadas a esta conta.

  - `results.account.loan_data.collected_at` (string, required)
    O carimbo de data/hora ISO-8601 quando o ponto de dados foi coletado.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.account.loan_data.loan_code` (string, required)
    O número de contrato padronizado específico do país.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "92792126019929279212650822221989319252576"

  - `results.account.loan_data.contract_amount` (number,null, required)
    O valor total inicial do empréstimo quando o contrato foi assinado, calculado pela instituição. Este valor inclui o principal + juros + impostos + taxas.
    Example: 202000

  - `results.account.loan_data.total_effective_cost` (number,null)
    O custo efetivo total inicial do empréstimo.
    Example: 209000

  - `results.account.loan_data.loan_type` (string, required)
    O tipo do empréstimo, de acordo com a instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "HOME_EQUITY"

  - `results.account.loan_data.outstanding_balance` (number,null, required)
    O valor restante a pagar no total, incluindo juros.
    Example: 182000

  - `results.account.loan_data.interest_rates` (array, required)
    Detalhamento dos juros aplicados ao empréstimo. Com o OF Brasil, recomendamos fortemente o uso das informações em interest_rate_data para obter informações detalhadas.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.

  - `results.account.loan_data.interest_rates.name` (string,null, required)
    O nome do tipo de taxa de juros aplicada ao empréstimo.

Nota: Para OFDA Brasil, recomendamos que você use o parâmetro interest_rate_data.tax_type.
    Example: "NOMINAL"

  - `results.account.loan_data.interest_rates.type` (string, required)
    O período em que o juro é aplicado ao empréstimo.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "MONTHLY", "YEARLY"

  - `results.account.loan_data.interest_rates.value` (number,null, required)
    A taxa de juros (em porcentagem ou valor monetário).

Nota: Para OFDA Brasil, recomendamos que você use os parâmetros interest_rate_data.pre_fixed_rate e interest_rate_data.post_fixed_rate.
    Example: 7.85

  - `results.account.loan_data.interest_rates.interest_rate_data` (object,null, required)
    Informações detalhadas sobre a taxa de juros.

  - `results.account.loan_data.interest_rates.interest_rate_data.tax_type` (string, required)
    O tipo de imposto sobre a taxa de juros. Retornamos um dos seguintes valores:

  - NOMINAL
  - EFFECTIVE
  
  > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "NOMINAL", "EFFECTIVE"

  - `results.account.loan_data.interest_rates.interest_rate_data.rate_type` (string, required)
    O tipo de taxa de juros. Retornamos um dos seguintes valores:

  - SIMPLE
  - COMPOUND

  > Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "SIMPLE", "COMPOUND"

  - `results.account.loan_data.interest_rates.interest_rate_data.type` (string)
    O período em que o juro é aplicado ao empréstimo.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "MONTHLY", "YEARLY"

  - `results.account.loan_data.interest_rates.interest_rate_data.calculation_base` (string, required)
    O cálculo base para a taxa de juros.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "30/360"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_type` (string, required)
    A taxa de índice de referência. Retornamos um dos seguintes valores:

  - WITHOUT_INDEX_TYPE
  - PRE_FIXED
  - POST_FIXED
  - FLOATING
  - INDEXED_PRICE
  - RURAL_CREDIT
  - OTHER_INDEX

  > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "WITHOUT_INDEX_TYPE", "PRE_FIXED", "POST_FIXED", "FLOATING", "INDEXED_PRICE", "RURAL_CREDIT", "OTHER_INDEX"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_subtype` (string,null, required)
    O subtipo da taxa de índice de referência.
    Example: "TR_TBF"

  - `results.account.loan_data.interest_rates.interest_rate_data.reference_index_info` (string,null, required)
    Informações adicionais sobre a taxa de índice de referência.
    Example: "Additional information"

  - `results.account.loan_data.interest_rates.interest_rate_data.pre_fixed_rate` (number, required)
    A taxa de juros com percentual prefixado.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: 0.062

  - `results.account.loan_data.interest_rates.interest_rate_data.post_fixed_rate` (number, required)
    A taxa de juros com percentual pós-fixado.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: 0.062

  - `results.account.loan_data.interest_rates.interest_rate_data.additional_info` (string,null, required)
    Informações adicionais sobre a taxa de juros.
    Example: "Additional information"

  - `results.account.loan_data.fees` (array,null, required)
    Detalhamento das taxas aplicadas ao empréstimo.

  - `results.account.loan_data.fees.type` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.
    Enum: "OPERATION_FEE", "INSURANCE_FEE", "OTHERS", null

  - `results.account.loan_data.fees.value` (number,null, required)
    O valor total da taxa. Mesma moeda do empréstimo.
    Example: 5.6

  - `results.account.loan_data.fees.name` (string, required)
    O nome da taxa.

 > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.
    Example: "Renovação de cadastro"

  - `results.account.loan_data.fees.code` (string, required)
    O código de tarifa.

 > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.
    Example: "CADASTRO"

  - `results.account.loan_data.fees.fee_charge_type` (string, required)
    Indica o tipo de cobrança. Retornamos um dos seguintes valores:

  - SINGLE
  - PER_INSTALLMENT

   > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.
    Enum: "SINGLE", "PER_INSTALLMENT"

  - `results.account.loan_data.fees.fee_charge` (string, required)
    Método de cobrança, conforme acordado com a instituição. Retornamos um dos seguintes valores:

  - MINIMUM
  - MAXIMUM
  - FIXED
  - PERCENTAGE

   > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo fees estiver disponível.
    Enum: "MINIMUM", "MAXIMUM", "FIXED", "PERCENTAGE"

  - `results.account.loan_data.fees.rate` (number,null, required)
    A taxa percentual da tarifa. Necessária quando fee_charge está definido como PERCENTAGE.
    Example: 0.062

  - `results.account.loan_data.contracted_charges` (array,null)
    Parece que você não forneceu nenhum texto para tradução. Por favor, envie o texto que deseja que eu traduza do inglês para o português (Brasil).

  - `results.account.loan_data.contracted_charges.type` (string)
    O tipo de cobrança contratada. Retornamos um dos seguintes valores:

  - LATE_PAYMENT_INTEREST_FEE
  - LATE_PAYMENT_PENALTY_FEE
  - DEFAULT_INTEREST_FEE
  - LOAN_CONTRACT_TAX
  - LATE_PAYMENT_TAX
  - NO_CHARGE
  - OTHER

  > Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo contracted_charges estiver disponível.
    Enum: "LATE_PAYMENT_INTEREST_FEE", "LATE_PAYMENT_PENALTY_FEE", "DEFAULT_INTEREST_FEE", "LOAN_CONTRACT_TAX", "LATE_PAYMENT_TAX", "NO_CHARGE", "OTHER"

  - `results.account.loan_data.contracted_charges.info` (string,null)
    Informações adicionais sobre a cobrança contratada.
    Example: "Late fee"

  - `results.account.loan_data.contracted_charges.rate` (number,null)
    A taxa percentual da cobrança, calculada com base no valor do empréstimo.
    Example: 0.062

  - `results.account.loan_data.collaterals` (array,null, required)
    Detalhes sobre quaisquer garantias de empréstimo que o indivíduo ou empresa forneceu.

  - `results.account.loan_data.collaterals.type` (string, required)
    O tipo de garantia, conforme definido pela instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.
    Example: "OPERACOES_GARANTIDAS_PELO_GOVERNO"

  - `results.account.loan_data.collaterals.subtype` (string, required)
    O subtipo da garantia, conforme definido pela instituição.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.
    Example: "CCR_CONVENIO_CREDITOS_RECIPROCOS"

  - `results.account.loan_data.collaterals.currency` (string, required)
    O código de moeda de três letras (ISO-4217).

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.
    Example: "BRL"

  - `results.account.loan_data.collaterals.amount` (number, required)
    O valor total da fatura.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil se o campo collaterals estiver disponível.
    Example: 45391.89

  - `results.account.loan_data.balloon_payments` (array,null, required)
    Informações detalhadas sobre quaisquer pagamentos de balloon para o empréstimo, se aplicável.

  - `results.account.loan_data.balloon_payments.due_date` (string,null, required)
    A data em que o pagamento do balloon deve ser efetuado, no formato YYYY-MM-DD.
    Example: "2021-09-06"

  - `results.account.loan_data.balloon_payments.currency` (string,null, required)
    O código de moeda de três letras (ISO-4217).
    Example: "BRL"

  - `results.account.loan_data.balloon_payments.amount` (number,null, required)
    O valor total do pagamento final.
    Example: 45391.89

  - `results.account.loan_data.installments_contract_term_frequency` (string,null, required)
    A frequência dos pagamentos parcelados contratados, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes:

  - DAY
  - WEEK
  - MONTH
  - YEAR
  - NO_DEADLINE_REMAINING
  - null
    Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null

  - `results.account.loan_data.installment_frequency` (string, required)
    A frequência com que as parcelas são pagas. Retornamos um dos seguintes valores:

  - IRREGULAR
  - WEEKLY
  - FORTNIGHTLY
  - MONTHLY
  - BIMONTHLY
  - QUARTERLY
  - BIANNUALLY
  - ANNUALLY
  - OTHER

  > Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Enum: "IRREGULAR", "WEEKLY", "FORTNIGHTLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "BIANNUALLY", "ANNUALLY", "OTHER"

  - `results.account.loan_data.installment_frequency_info` (string,null, required)
    Informações adicionais sobre o installment_frequency.
    Example: "Both the term and requency are the same."

  - `results.account.loan_data.first_installment_due_date` (string,null, required)
    A data em que a primeira parcela do empréstimo deve ser paga, no formato YYYY-MM-DD.
    Example: "2020-03-01"

  - `results.account.loan_data.number_of_installments_total` (integer,null, required)
    O número total de parcelas necessárias para quitar o empréstimo.
    Example: 60

  - `results.account.loan_data.number_of_installments_outstanding` (integer,null, required)
    O número de parcelas restantes a pagar.
    Example: 48

  - `results.account.loan_data.number_of_installments_paid` (integer,null, required)
    O número de parcelas já pagas.
    Example: 32

  - `results.account.loan_data.number_of_installments_past_due` (integer,null, required)
    O número de parcelas que estão em atraso.
    Example: 2

  - `results.account.loan_data.disbursement_dates` (array,null, required)
    Um array de datas em que o empréstimo foi desembolsado.
    Example: ["2021-09-23"]

  - `results.account.loan_data.settlement_date` (string,null, required)
    A data em que o empréstimo foi liquidado, no formato YYYY-MM-DD.
    Example: "2021-09-23"

  - `results.account.loan_data.contract_start_date` (string, required)
    A data em que o contrato de empréstimo foi assinado, no formato YYYY-MM-DD.

> Não anulável: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "2020-03-01"

  - `results.account.loan_data.contract_end_date` (string,null, required)
    A data em que se espera que o empréstimo seja concluído, no formato YYYY-MM-DD.
    Example: "2027-10-01"

  - `results.account.loan_data.contract_remaining_frequency` (string,null, required)
    A frequência dos pagamentos das parcelas restantes contratadas, conforme definido quando o contrato foi assinado pela primeira vez. Retornamos um dos seguintes valores:
- DAY
- WEEK
- MONTH
- YEAR
- NO_DEADLINE_REMAINING
- null
    Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null

  - `results.account.loan_data.contract_remaining_total` (integer,null, required)
    O número total de parcelas restantes no empréstimo.
    Example: 20

  - `results.account.loan_data.amortization_schedule` (string, required)
    O cronograma de amortização do empréstimo.

> Non-nullable: Um valor deve ser retornado pela rede de open finance do Brasil.
    Example: "SEM_SISTEMA_AMORTIZACAO"

  - `results.account.loan_data.amortization_schedule_info` (string,null, required)
    Informações adicionais sobre o amortization_schedule.
    Example: "No need for a schedule."

  - `results.account.loan_data.consignee_id` (string,null, required)
    O ID do consignatário do empréstimo.
    Example: "60500998000135"

  - `results.account.loan_data.contract_number` (string,null, required)
    O número do contrato do empréstimo, conforme fornecido pela instituição.
    Example: "1324926521496"

  - `results.account.loan_data.monthly_payment` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.principal` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.payment_day` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.outstanding_principal` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.credit_limit` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.last_period_balance` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.interest_rate` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.limit_day` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.cutting_day` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.cutting_date` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.last_payment_date` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.loan_data.no_interest_payment` (number,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.account.funds_data` (string,null, required)
    Nota: Este campo não se aplica ao OF Brasil e retornará null.

  - `results.name` (string,null, required)
    O nome para a despesa recorrente.

ℹ️ Nota: Esta informação é retirada da seção de descrição de uma transação e, em seguida, normalizada para fornecer um nome de fácil leitura. Assim, às vezes o nome refletirá o comerciante para o qual o pagamento é feito (por exemplo, Netflix.com), enquanto para outras despesas recorrentes, isso pode ser algo como "Pagamento mensal para John".
    Example: "Netflix"

  - `results.transactions` (array, required)
    Um array de objetos de transação minificados usado para avaliar a despesa recorrente. Se nenhuma transação for encontrada, retornamos um array vazio.

  - `results.transactions.amount` (number, required)
    O valor da transação.
    Example: 2145.45

  - `results.transactions.description` (string,null, required)
    A descrição da transação fornecida pela instituição. Normalmente, este é o texto que o usuário final veria no extrato bancário. A descrição pode ser uma string vazia.

Nota: Para o EYOD Risk Insights, a descrição é aquela que você forneceu na solicitação inicial.
    Example: "Netflix.com/march"

  - `results.transactions.value_date` (string, required)
    A data em que a transação ocorreu, no formato YYYY-MM-DD.
    Example: "2019-10-23"

  - `results.frequency` (string, required)
    A frequência com que essa despesa recorrente ocorre.

ℹ️ Nota: A Belvo identifica apenas frequências MONTHLY.
    Enum: "MONTHLY"

  - `results.average_transaction_amount` (number, required)
    O valor médio da transação da despesa recorrente.
    Example: 32.9

  - `results.median_transaction_amount` (number, required)
    O valor mediano da transação da despesa recorrente.
    Example: 32.9

  - `results.days_since_last_transaction` (integer, required)
    Número de dias desde que a última despesa recorrente ocorreu.

Com base na frequência, você pode inferir quantos dias faltam até que a próxima cobrança ocorra.
    Example: 5

  - `results.category` (string, required)
    A categoria de transação para a despesa recorrente.

- Online Platforms & Leisure (Netflix, Spotify, Assinaturas de Academia)
- Bills & Utilities (eletricidade, telefone, internet)
- Credits & Loans (adiantamentos em dinheiro de cartão de crédito, empréstimo estudantil, leasing de embarcações)
- Insurance (seguro residencial, automotivo, e de saúde & vida)
- Transport & Travel (viagem de Uber, airbnb, estacionamento)
- Taxes (taxa de serviço, doação, taxas judiciais)
    Enum: "Bills & Utilities", "Credits & Loans", "Insurance", "Online Platforms & Leisure", "Transport & Travel", "Taxes"

  - `results.payment_type` (string,null, required)
    O tipo de despesa recorrente. Retornamos um dos seguintes valores:

  - SUBSCRIPTION
  - REGULAR
    Enum: "SUBSCRIPTION", "REGULAR"

## Response 403 fields (application/json):

  - `code` (string)
    Um código de erro único (access_to_resource_denied) que permite classificar e tratar o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Uma breve descrição do erro.

Para erros access_to_resource_denied, a descrição é:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Um código de erro único (not_found) que permite classificar e lidar com o erro programaticamente.
    Example: "not_found"

  - `message` (string)
    Uma breve descrição do erro.

Para erros not_found, a descrição é:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Um código de erro único (request_timeout) que permite classificar e lidar com o erro programaticamente.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Uma breve descrição do erro.

Para erros de request_timeout, a descrição é:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 428 fields (application/json):

  - `code` (string)
    Um código de erro único (token_required) que permite classificar e lidar com o erro programaticamente.
ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 428 token_required.
    Example: "token_required"

  - `message` (string)
    Uma breve descrição do erro. Para erros token_required, a descrição é:

- A instituição requer um token MFA para fazer login.
    Example: "A MFA token is required by the institution to login"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

  - `session` (string)
    Um ID único de 32 caracteres da sessão de login (correspondente a um padrão regex de: [a-f0-9]{32}).
    Example: "2675b703b9d4451f8d4861a3eee54449"

  - `expiry` (integer)
    Tempo de duração da sessão em segundos.
    Example: 9600

  - `link` (string)
    Identificador único criado pela Belvo, usado para referenciar o Link atual.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `token_generation_data` (object)
    Detalhes sobre como gerar o token.

  - `token_generation_data.instructions` (string)
    Instruções para geração de token.
    Example: "Use this code to generate the token"

  - `token_generation_data.type` (string)
    Tipo de dados para gerar o token (QR code, desafio numérico).
    Example: "numeric"

  - `token_generation_data.value` (string)
    Valor a ser usado para gerar o token.
    Example: "12345"

  - `token_generation_data.expects_user_input` (boolean)
    Indica se o usuário precisa fornecer entrada para concluir a autenticação. Quando definido como false, seu usuário pode precisar:
- confirmar o login em outro dispositivo
- escanear um código QR
Você ainda precisará fazer uma chamada PATCH para concluir a solicitação.
    Example: true

## Response 500 fields (application/json):

  - `code` (string)
    Um código de erro único (unexpected_error) que permite classificar e tratar o erro de forma programática.

ℹ️ Consulte nosso DevPortal para mais informações sobre como lidar com erros 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Uma breve descrição do erro.

Para erros unexpected_error, a descrição é:

  - Belvo não consegue processar a solicitação devido a um problema interno do sistema ou a uma resposta não suportada de uma instituição.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Um ID único de 32 caracteres da solicitação (correspondente a um padrão regex de: [a-f0-9]{32}). Forneça este ID ao entrar em contato com a equipe de suporte da Belvo para acelerar as investigações.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"