Loans & mortgages | INFONITE

[
  {
    "begin_date": "2024-01-01",
    "current_period": 32,
    "customer_segment": "personal",
    "end_date": "2030-01-01",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "id": "6aa75284bfa8241c43cb6304",
    "identifier": {
      "control_digits": "61",
      "entity_code": "9999",
      "entity_office": "9837",
      "type": "generic",
      "value": "9876543210"
    },
    "initial_balance": {
      "amount": "30000.00",
      "currency": "EUR"
    },
    "interest_rate": {
      "description": "TIN",
      "unit": "%",
      "value": "5.500000"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES379999************8314",
      "type": "iban",
      "value": "ES3799990000186703078314"
    },
    "next_payment_amount": {
      "amount": "416.67",
      "currency": "EUR"
    },
    "next_payment_date": "2026-10-01",
    "outstanding_balance": {
      "amount": "-16666.67",
      "currency": "EUR"
    },
    "pending_periods": 40,
    "product": "financial_loan",
    "product_alias": "Mi Préstamo Personal",
    "product_description": "Préstamo Personal para pruebas",
    "product_name": "Préstamo Personal",
    "sub_family": "financial_loan:personal",
    "total_periods": 72
  },
  {
    "begin_date": "2020-01-01",
    "current_period": 80,
    "customer_segment": "personal",
    "end_date": "2050-01-01",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "id": "6aa75284bfa8241c43cb6303",
    "identifier": {
      "control_digits": "60",
      "entity_code": "9999",
      "entity_office": "0000",
      "type": "generic",
      "value": "0123456789"
    },
    "initial_balance": {
      "amount": "100000.00",
      "currency": "EUR"
    },
    "interest_rate": {
      "description": "TAE",
      "unit": "%",
      "value": "2.500000"
    },
    "linked_account": {
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES379999************8314",
      "type": "iban",
      "value": "ES3799990000186703078314"
    },
    "next_payment_amount": {
      "amount": "277.78",
      "currency": "EUR"
    },
    "next_payment_date": "2026-10-01",
    "outstanding_balance": {
      "amount": "-77777.78",
      "currency": "EUR"
    },
    "pending_periods": 280,
    "product": "financial_loan",
    "product_alias": "Mi Hipoteca",
    "product_description": "Hipoteca para pruebas",
    "product_name": "Hipoteca",
    "renovation_date": "2027-01-01",
    "sub_family": "financial_loan:mortgage",
    "total_periods": 360
  }
]

Loans, mortgages and financing granted by the institution.

Each one carries the amount granted and the amount outstanding, the instalment, the rate, the dates, the account it is charged to and the repayment record the institution publishes. Field by field in Loans & mortgages.

Half of an affordability assessment lives here, and the other half in the credit registry: this endpoint shows what this institution lent, the registry shows what everybody else did.

Requires the loans_read feature

Features are chosen when the execution starts, not here. An execution that did not ask for loans_read answers 204, and the only way to get the data is to run another one.

Status	Meaning
`200`	The loans and mortgages.
`202`	`feature_not_ready` — `loans_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `loans_read`. No body.
`404`	No execution with that id for your application, or it has been deleted.

Server to server only. This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read.

Authentication

X-APP-SECRETstring

Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"

The execution, as the acceptance response returned it.

Response

200 OK
Personal loans and mortgages, with the principal, what is still owed, the instalment and the schedule the institution reports.

An empty list is an answer, not a gap: the feature ran and the source reported none.

Personal Loanobject

Mortgageobject

Errors

404

Not Found Error

422

Unprocessable Entity Error