> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://infonite.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://infonite.dev/_mcp/server. # Pension plans GET https://clients.infonite.tech/api/executions/results/{execution_id}/financial/v1/investments/pensions 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). **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. 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. Reference: https://infonite.dev/api-reference/direct-executions/direct-executions-api/fetching-the-results/financial-data/direct-executions-v-1-results-financial-pension-plans ## Authentication - `X-APP-SECRET` header (required) — Application Secret ## Servers - `https://clients.infonite.tech/api` (Legacy Server, default) - `https://clients.infonite.io/api` (Production Server) ## Request ### Path parameters - `execution_id` (string, required) — The execution, as the acceptance response returned it. ## Response ### 200 **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. - `list of object` - `id` (string, required) — Product ID for the current execution. Note: it may change between executions. - `product` ("pension_plan", required) - `sub_family` (enum, required) — Pension plan type - Allowed values: `pension_plan:pension` - `fetch_date` (string, required) — Date this product was fetched - `identifier` (object, required) — Plan number - `type`: `generic` (Generic Identifier) - `value` (string, required) — Identifier - `control_digits` (string, optional) — Control digits - `entity_code` (string, optional) — Entity code - `entity_country` (string, optional) — Entity country - `entity_office` (string, optional) — Entity office - `customer_segment` (enum, required) - Allowed values: `not_assigned`, `personal`, `business`, `corporate`, `private`, `retail` - `product_name` (string, required) — Product name - `linked_account` (object, optional) — Account identifier - `type`: `clabe` (CLABE) - `control_digits` (string, required) — Control digit - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial Clabe - `value` (string, required) — Clave Bancaria Estandarizada - `type`: `generic` (Generic Identifier) - `value` (string, required) — Identifier - `control_digits` (string, optional) — Control digits - `entity_code` (string, optional) — Entity code - `entity_country` (string, optional) — Entity country - `entity_office` (string, optional) — Entity office - `type`: `iban` (IBAN) - `control_digits` (string, required) — Control digits - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial IBAN - `value` (string, required) — International Bank Account Number - `product_alias` (string, optional) — Product alias - `product_description` (string, optional) — Product Description - `category` (string, optional) — Plan Category - `begin_date` (date, optional) — Begin date - `end_date` (date, optional) — End Date - `total_contribution` (object, optional) — Total contribution - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `year_to_date_contribution` (object, optional) — Year to date contribution - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `unit_price` (object, optional) — Unit price - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, optional, default: nan) — Decimal number with 6 digits precision - `quantity` (string, optional, default: nan) — The number of units of a financial instrument held by the account. - `valuation` (object, optional) — The monetary value of a financial instrument held by the account. - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `valuation_date` (date, optional) — Valuation date - `performance` (object, optional) — Total Performance - `value` (string, optional, default: NaN) — Decimal number with 6 digits precision - `unit` ("%" or string, optional, default: %) - `description` (string, optional, nullable) - `performance_year_to_date` (object, optional) — Year to date performance - `value` (string, optional, default: NaN) — Decimal number with 6 digits precision - `unit` ("%" or string, optional, default: %) - `description` (string, optional, nullable) - `performance_last_12_months` (object, optional) — Last 12 months performance - `value` (string, optional, default: NaN) — Decimal number with 6 digits precision - `unit` ("%" or string, optional, default: %) - `description` (string, optional, nullable) - `appreciation` (object, optional) — The monetary value of the appreciation of a financial instrument held by the account. - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, optional, default: nan) — Decimal number with 6 digits precision ### 202 **202 Accepted**`feature_not_ready`: `pensions_read` is still running. **You do not have to wait for the whole execution** — every family answers as soon as its own feature closes, so a slow source does not hold up the ones that already finished. - `detail` (string, required) — Error message ## Errors ### 404 Not Found Error **404 Not Found**No execution with that id for your application, or it has been deleted. - `detail` (string, required) — Error message ### 422 Unprocessable Entity Error Validation Error - `detail` (list of object, optional) - `loc` (list of string or integer, required) - `msg` (string, required) - `type` (string, required) - `input` (any, optional) - `ctx` (object, optional) ## Examples ### One private pension plan **Response** ```json [ { "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" } } ] ``` **SDK Code** ```python One private pension plan import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript One private pension plan const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go One private pension plan package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby One private pension plan require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java One private pension plan import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions") .header("X-APP-SECRET", "") .asString(); ``` ```php One private pension plan request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp One private pension plan using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift One private pension plan import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### This family has not finished **Response** ```json { "detail": "feature_not_ready" } ``` **SDK Code** ```python This family has not finished import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript This family has not finished const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go This family has not finished package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby This family has not finished require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java This family has not finished import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions") .header("X-APP-SECRET", "") .asString(); ``` ```php This family has not finished request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp This family has not finished using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift This family has not finished import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/investments/pensions")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```