v1

latestOpenAPI 3.0.22026-08-061464031.4 MB
Bills

Get a bill's details

Get the details of a specific bill.

get/api/bills/{id}/

Path parameters

idstring uuid required

The bill.id you want to get detailed information about.

Query parameters

omitstring

Omit certain fields from being returned in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

fieldsstring

Return only the specified fields in the response. For more information, see our <a href="https://developers.belvo.com/docs/searching-and-filtering" target="_blank">Filtering responses</a> DevPortal article.

Response

Ok

idstring uuid

Belvo's unique identifier for the current item.

created_atstring date-time

The ISO-8601 timestamp of when the data point was created in Belvo's database.

collected_atstring date-time

The ISO-8601 timestamp when the data point was collected.

internal_identificationstring nullable

The institution's internal identifier for the bill.

bill_namestring nullable

The title of the monthly credit card bill the transaction belongs to. The format of the returned value is institution specific, however, some common examples are:

  • diciembre-2021
  • dec-2021
  • dec-21

Note: This field is only returned for 'closed' bills (meaning the billing period has ended and the bill has been emitted). If the billing period is still ongoing, we return null.

due_datestring date nullable

The date that the bill is to be paid, in YYYY-MM-DD format.

currencystring nullable

The three-letter currency code (ISO-4217).

total_amountnumber float nullable

The total amount of the bill.

minimum_amountnumber float nullable

The minimum amount to pay.

is_installmentboolean nullable

Boolean to indicate whether this bill can be paid in installments.

Example response

{
  "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
  "created_at": "2022-02-09T08:45:50.406032Z",
  "collected_at": "2022-02-09T08:45:50.406032Z",
  "account": {
    "id": "0d3ffb69-f83b-456e-ad8e-208d0998d71d",
    "link": "30cb4806-6e00-48a4-91c9-ca55968576c8",
    "institution": {
      "name": "erebor_mx_retail"
    },
    "collected_at": "2022-02-09T08:45:50.406032Z",
    "created_at": "2022-02-09T08:45:50.406032Z",
    "last_accessed_at": "2021-03-09T10:28:40.000Z",
    "category": "CHECKING_ACCOUNT",
    "balance_type": "ASSET",
    "overdraft": {
      "arranged": 5000.5,
      "used": 1000.5,
      "unarranged": 300.1
    },
    "type": "STANDARD_NACIONAL",
    "subtype": "FINANCIAMENTO_HABITACIONAL_SFH",
    "name": "Cuenta Perfiles- M.N. - MXN-666",
    "number": "4057068115181",
    "agency": "6272",
    "check_digit": "7",
    "balance": {
      "current": 5874.13,
      "available": 5621.12,
      "blocked": 60.32,
      "automatically_invested": 131.5
    },
    "currency": "BRL",
    "public_identification_name": "AGENCY/ACCOUNT",
    "public_identification_value": "0444/45722-0",
    "internal_identification": "92792126019929279212650822221989319252576",
    "credit_data": {
      "collected_at": "2022-02-09T08:45:50.406032Z",
      "credit_limit": 192000.9,
      "limits": [
        {
          "identification_number": "4453",
          "credit_limit": 1000.04,
          "used_amount": 400.04,
          "available_amount": 600,
          "type": "TOTAL_LIMIT",
          "consolidation_type": "INDIVIDUAL",
          "line_name": "CREDITO_A_VISTA",
          "line_name_additional_info": "Informações adicionais e complementares"
        }
      ],
      "cutting_date": "2019-12-11",
      "minimum_payment": 2400.3,
      "network": "MASTERCARD",
      "network_additional_info": "It's an orange card.",
      "cards": [
        {
          "identification_number": "4453"
        }
      ]
    },
    "loan_data": {
      "collected_at": "2022-02-09T08:45:50.406032Z",
      "loan_code": "92792126019929279212650822221989319252576",
      "contract_amount": 202000,
      "total_effective_cost": 209000,
      "loan_type": "HOME_EQUITY",
      "outstanding_balance": 182000,
      "interest_rates": [
        {
          "name": "NOMINAL",
          "type": "MONTHLY",
          "value": 7.85,
          "interest_rate_data": {
            "tax_type": "NOMINAL",
            "rate_type": "SIMPLE",
            "type": "MONTHLY",
            "calculation_base": "30/360",
            "reference_index_type": "FLOATING",
            "reference_index_subtype": "TR_TBF",
            "reference_index_info": "Additional information",
            "pre_fixed_rate": 0.062,
            "post_fixed_rate": 0.062,
            "additional_info": "Additional information"
          }
        }
      ],
      "fees": [
        {
          "value": 5.6,
          "name": "Renovação de cadastro",
          "code": "CADASTRO",
          "fee_charge_type": "SINGLE",
          "fee_charge": "FIXED",
          "rate": 0.062
        }
      ],
      "contracted_charges": [
        {
          "type": "LATE_PAYMENT_INTEREST_FEE",
          "info": "Late fee",
          "rate": 0.062
        }
      ],
      "collaterals": [
        {
          "type": "OPERACOES_GARANTIDAS_PELO_GOVERNO",
          "subtype": "CCR_CONVENIO_CREDITOS_RECIPROCOS",
          "currency": "BRL",
          "amount": 45391.89
        }
      ],
      "balloon_payments": [
        {
          "due_date": "2021-09-06",
          "currency": "BRL",
          "amount": 45391.89
        }
      ],
      "installments_contract_term_frequency": "MONTH",
      "installment_frequency": "MONTHLY",
      "installment_frequency_info": "Both the term and requency are the same.",
      "first_installment_due_date": "2020-03-01",
      "number_of_installments_total": 60,
      "number_of_installments_outstanding": 48,
      "number_of_installments_paid": 32,
      "number_of_installments_past_due": 2,
      "disbursement_dates": [
        "2021-09-23"
      ],
      "settlement_date": "2021-09-23",
      "contract_start_date": "2020-03-01",
      "contract_end_date": "2027-10-01",
      "contract_remaining_frequency": "MONTH",
      "contract_remaining_total": 20,
      "amortization_schedule": "SEM_SISTEMA_AMORTIZACAO",
      "amortization_schedule_info": "No need for a schedule.",
      "consignee_id": "60500998000135",
      "contract_number": "1324926521496"
    }
  },
  "internal_identification": "92792126019929279212650822221989319252576",
  "bill_name": "apr-2020",
  "due_date": "2021-09-06",
  "currency": "BRL",
  "total_amount": 45391.89,
  "minimum_amount": 391.89,
  "finance_charges": [
    {
      "type": "LATE_PAYMENT_INTEREST",
      "additional_info": "Paid 15 days late, fee applied.",
      "currency": "BRL",
      "amount": 91.89
    }
  ],
  "payments": [
    {
      "type": "INSTALLMENT",
      "payment_date": "2021-09-04",
      "payment_mode": "DIRECT_DEBIT",
      "currency": "BRL",
      "amount": 500.15
    }
  ]
}