Pension plans | INFONITE

[
  {
    "id": "6aa75284bfa8241c43cb6306",
    "product": "pension_plan",
    "sub_family": "pension_plan:pension",
    "fetch_date": "2026-09-12T01:48:52+00:00",
    "identifier": {
      "type": "generic",
      "value": "0011223345",
      "control_digits": "62",
      "entity_code": "9999",
      "entity_office": "5143"
    },
    "customer_segment": "personal",
    "product_name": "PLAN EXAMPLE CLASS A",
    "linked_account": {
      "type": "iban",
      "control_digits": "17",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES969999************9653",
      "value": "ES9699990000171900259653"
    },
    "product_alias": "Example Plan Class A",
    "product_description": "Example Plan Class A - 2024",
    "category": "Dummy Category",
    "begin_date": "2024-01-01",
    "end_date": "2050-01-01",
    "total_contribution": {
      "currency": "EUR",
      "amount": "10000.00"
    },
    "year_to_date_contribution": {
      "currency": "EUR",
      "amount": "500.00"
    },
    "unit_price": {
      "currency": "EUR",
      "amount": "2.000000"
    },
    "quantity": "1000.000000",
    "valuation": {
      "currency": "EUR",
      "amount": "2000.00"
    },
    "valuation_date": "2026-09-12",
    "performance": {
      "value": "-4.000000",
      "unit": "%",
      "description": "Rendimiento"
    },
    "performance_year_to_date": {
      "value": "-4.005000",
      "unit": "%",
      "description": "Rendimiento"
    },
    "performance_last_12_months": {
      "value": "-4.010000",
      "unit": "%",
      "description": "Rendimiento"
    },
    "appreciation": {
      "currency": "EUR",
      "amount": "-8000.000000"
    }
  }
]

Private pension plans held at the institution.

Each plan carries its identifiers, the accumulated balance, the contributions recorded and the valuation the institution publishes. Field by field in Investments.

This is the private side of retirement saving. What the state pays comes from the administration instead, through Public pensions — a different source, a different feature, and frequently a different answer.

Requires the pensions_read feature

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

Status	Meaning
`200`	The plans.
`202`	`feature_not_ready` — `pensions_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `pensions_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.

Private pension plans held at the institution. Each plan carries its identifiers, the accumulated balance, the contributions recorded and the valuation the institution publishes. Field by field in [Investments](/guides/data-models/banking/investments). <Note> **This is the private side of retirement saving.** What the state pays comes from the administration instead, through [Public pensions](api:GET/executions/results/{execution_id}/public/v1/pensions) — a different source, a different feature, and frequently a different answer. </Note> <Note title="Requires the `pensions_read` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `pensions_read` answers `204`, and the only way to get the data is to run another one. </Note> | Status | Meaning | | :--- | :--- | | `200` | The plans. | | `202` | `feature_not_ready` — `pensions_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `pensions_read`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **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. </Note>

Authentication

X-APP-SECRETstring

Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"

The execution, as the acceptance response returned it.

Response

200 OK
Private pension plans held at the institution — the ones a person contracts. The state pension is a public record and lives in its own endpoint.

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

**200 OK**<br>**Private** pension plans held at the institution — the ones a person contracts. The state pension is a public record and lives in its own endpoint. **An empty list is an answer, not a gap**: the feature ran and the source reported none.

idstringformat: "object-id"

Product ID for the current execution. Note: it may change between executions.

product"pension_plan"

sub_familyenum

Pension plan type

fetch_datestringformat: "datetime"

Date this product was fetched

identifierobject

Plan number

customer_segmentenum

product_namestring

Product name

linked_accountobjectOptional

Account identifier

product_aliasstringOptional

Product alias

product_descriptionstringOptional

Product Description

categorystringOptional

Plan Category

begin_datedateOptional

Begin date

end_datedateOptional

End Date

total_contributionobjectOptional

Total contribution

year_to_date_contributionobjectOptional

Year to date contribution

unit_priceobjectOptional

Unit price

quantitystringOptionalformat: "number"Defaults to nan

The number of units of a financial instrument held by the account.

valuationobjectOptional

The monetary value of a financial instrument held by the account.

valuation_datedateOptional

Valuation date

performanceobjectOptional

Total Performance

performance_year_to_dateobjectOptional

Year to date performance

performance_last_12_monthsobjectOptional

Last 12 months performance

appreciationobjectOptional

The monetary value of the appreciation of a financial instrument held by the account.

Errors

404

Not Found Error

422

Unprocessable Entity Error