Accounts

GET

/executions/results/:execution_id/financial/v1/accounts

GET

/api/executions/results/:execution_id/financial/v1/accounts

curl https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/accounts \
     -H "X-APP-SECRET: <apiKey>"

[
  {
    "id": "6aa75283bfa8241c43cb62e0",
    "product": "financial_account",
    "sub_family": "financial_account:current",
    "fetch_date": "2026-09-12T01:48:51+00:00",
    "data_enrichment": "skipped",
    "identifier": {
      "type": "iban",
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES379999************8314",
      "value": "ES3799990000186703078314"
    },
    "customer_segment": "personal",
    "product_name": "Cuenta de Ejemplo 0",
    "product_alias": "Mi Cuenta de Ejemplo 0 en EUR",
    "product_description": "Cuenta de Ejemplo para pruebas 0",
    "opening_date": "2023-01-01",
    "transactions": [
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1512.00"
        },
        "descriptions": [
          "Transaction 5"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1612.00"
        },
        "descriptions": [
          "Transaction 4"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1712.00"
        },
        "descriptions": [
          "Transaction 3"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1812.00"
        },
        "descriptions": [
          "Transaction 2"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1912.00"
        },
        "descriptions": [
          "Transaction 1"
        ]
      }
    ],
    "holders": [
      {
        "role": "holder",
        "name": "MOISÉS ÁGUILA BARRANCO",
        "identifier": {
          "type": "es:dni",
          "value": "85253469J",
          "validated": true,
          "country": "ES"
        }
      }
    ],
    "available": {
      "currency": "EUR",
      "amount": "1512.00"
    },
    "booked": {
      "currency": "EUR",
      "amount": "1512.00"
    }
  },
  {
    "id": "6aa75283bfa8241c43cb62e1",
    "product": "financial_account",
    "sub_family": "financial_account:current",
    "fetch_date": "2026-09-12T01:48:51+00:00",
    "data_enrichment": "skipped",
    "identifier": {
      "type": "iban",
      "control_digits": "18",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES429999************8040",
      "value": "ES4299990000180496468040"
    },
    "customer_segment": "personal",
    "product_name": "Cuenta de Ejemplo 1",
    "product_alias": "Mi Cuenta de Ejemplo 1 en EUR",
    "product_description": "Cuenta de Ejemplo para pruebas 1",
    "opening_date": "2023-01-01",
    "transactions": [
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1331.42"
        },
        "descriptions": [
          "Transaction 5"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1431.42"
        },
        "descriptions": [
          "Transaction 4"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1531.42"
        },
        "descriptions": [
          "Transaction 3"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1631.42"
        },
        "descriptions": [
          "Transaction 2"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "EUR",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "EUR",
          "amount": "1731.42"
        },
        "descriptions": [
          "Transaction 1"
        ]
      }
    ],
    "holders": [
      {
        "role": "holder",
        "name": "MOISÉS ÁGUILA BARRANCO",
        "identifier": {
          "type": "es:dni",
          "value": "85253469J",
          "validated": true,
          "country": "ES"
        }
      },
      {
        "role": "authorized",
        "name": "EMMA RÍO FERRANDO",
        "identifier": {
          "type": "es:dni",
          "value": "50214545W",
          "validated": true,
          "country": "ES"
        }
      }
    ],
    "available": {
      "currency": "EUR",
      "amount": "1331.42"
    },
    "booked": {
      "currency": "EUR",
      "amount": "1331.42"
    }
  },
  {
    "id": "6aa75283bfa8241c43cb62e2",
    "product": "financial_account",
    "sub_family": "financial_account:current",
    "fetch_date": "2026-09-12T01:48:51+00:00",
    "data_enrichment": "skipped",
    "identifier": {
      "type": "iban",
      "control_digits": "13",
      "entity_code": "9999",
      "entity_country": "ES",
      "entity_office": "0000",
      "masked": "ES479999************8219",
      "value": "ES4799990000132533118219"
    },
    "customer_segment": "personal",
    "product_name": "Cuenta de Ejemplo 2",
    "product_alias": "Mi Cuenta de Ejemplo 2 en USD",
    "product_description": "Cuenta de Ejemplo para pruebas 2",
    "opening_date": "2023-01-01",
    "transactions": [
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "USD",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "USD",
          "amount": "1695.49"
        },
        "descriptions": [
          "Transaction 5"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "USD",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "USD",
          "amount": "1795.49"
        },
        "descriptions": [
          "Transaction 4"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-09-12",
        "value_date": "2026-09-12",
        "amount": {
          "currency": "USD",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "USD",
          "amount": "1895.49"
        },
        "descriptions": [
          "Transaction 3"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "USD",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "USD",
          "amount": "1995.49"
        },
        "descriptions": [
          "Transaction 2"
        ]
      },
      {
        "type": "default",
        "status": "booked",
        "category": "expenses::other::other expenses",
        "operation_date": "2026-08-15",
        "value_date": "2026-08-15",
        "amount": {
          "currency": "USD",
          "amount": "-100.00"
        },
        "balance": {
          "currency": "USD",
          "amount": "2095.49"
        },
        "descriptions": [
          "Transaction 1"
        ]
      }
    ],
    "holders": [
      {
        "role": "authorized",
        "name": "MOISÉS ÁGUILA BARRANCO",
        "identifier": {
          "type": "es:dni",
          "value": "85253469J",
          "validated": true,
          "country": "ES"
        }
      },
      {
        "role": "holder",
        "name": "EMMA RÍO FERRANDO",
        "identifier": {
          "type": "es:dni",
          "value": "50214545W",
          "validated": true,
          "country": "ES"
        }
      }
    ],
    "available": {
      "currency": "USD",
      "amount": "1695.49"
    },
    "booked": {
      "currency": "USD",
      "amount": "1695.49"
    }
  }
]

Current, savings and other cash accounts, with their balances and transactions.

Each account carries its identifiers (IBAN and the source’s own), currency, balances, holders and the transactions retrieved. Field by field — including the categories every transaction arrives with — in Accounts.

Requires the accounts_read feature

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

Transactions and holders are opt-in: read_transactions and read_holders both default to false, so a run that did not ask for them returns the accounts with balances and nothing else. How far back the movements go is decided by from_date / to_date and by what the institution allows — Show engine details states the limits of each engine.

Status	Meaning
`200`	The accounts, each with the transactions retrieved for it.
`202`	`feature_not_ready` — `accounts_read` is still running. Only this family waits: the ones that already closed answer now.
`204`	The execution never asked for `accounts_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.

Current, savings and other cash accounts, with their balances and transactions. Each account carries its identifiers (IBAN and the source's own), currency, balances, holders and the transactions retrieved. Field by field — including the categories every transaction arrives with — in [Accounts](/guides/data-models/banking/accounts). <Note title="Requires the `accounts_read` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `accounts_read` answers `204`, and the only way to get the data is to run another one. **Transactions and holders are opt-in**: `read_transactions` and `read_holders` both default to `false`, so a run that did not ask for them returns the accounts with balances and nothing else. How far back the movements go is decided by `from_date` / `to_date` and by what the institution allows — [Show engine details](api:GET/config/engines/{engine_reference}) states the limits of each engine. </Note> | Status | Meaning | | :--- | :--- | | `200` | The accounts, each with the transactions retrieved for it. | | `202` | `feature_not_ready` — `accounts_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `accounts_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
Every cash account the source reported — current, savings and the rest — each with its identifiers, currency, balances, holders and the transactions retrieved.

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"financial_account"

sub_family"financial_account:current"

fetch_datestringformat: "datetime"

Date this product was fetched

data_enrichmentenum

Data enrichment status. Indicates whether the product has been enriched with additional data. If not, the product will be filled with generic data.

identifierobject

Account identifier

customer_segmentenum

product_namestring

Product name

product_aliasstringOptional

Product alias

product_descriptionstringOptional

Product Description

opening_datedateOptional

Account opening date

transactionslist of objectsOptional

Account transactions

holderslist of objectsOptional

Account holders

availableobjectOptionalDeprecated

The total accessible funds, considering all cleared and uncleared transactions. This represents the amount a user can use or withdraw immediately.

bookedobjectOptionalDeprecated

The net monetary amount without considering pending transactions. It reflects the actual balance at any given moment.

Errors

404

Not Found Error

422

Unprocessable Entity Error