Financial Product Type

You're reading version 2025-01-01, which is not the latest. The latest is 2026-04-01: see this page in 2026-04-01.

FR · Wealth API · 2025-01-01

FrenchLivret

Savings · Covers Livret A, LDDS, LEP, CEL, PEL, Livret Jeune, compte sur livret

French Livret (regulated savings account)

classificationstring

Classification of the French livret account.

Possible Enum values are LIVRET_A, LDDS, LEP, CEL, PEL, COMPTE_SUR_LIVRET, LIVRET_JEUNE or UNKNOWN.
companystringrequired

Company where the livret has been collected from. Examples: fr-hellobank, fr-boursorama, fr-bred, fr-la-banque-postale, fr-credit-agricole, fr-finary.

companyDisplayNamestringrequired

Display name of the company for user-friendly presentation.

currentValueMonetaryAmount

Current value of the account

Deposit information for the livret, representing the principal amount deposited, excluding accrued interest.

Information about the owner of the livret account.

idstringrequired

Insurely-generated unique identifier for this collection of the financial product. Randomly generated and not stable across collections — a new id is issued each time the product is collected, even for the same underlying account. Use this only as a handle within a single collection (e.g., to correlate holdings and transactions). Do not use it to recognize the same product over time; use the stable institution-assigned identifier on this product (e.g., productNumber, accountNumber, or loanId) for that.

Interest information for the account

productNamestring

Name of the product

productNumberstring

The account number assigned by the source financial institution. This is the most stable identifier for the account over time and across collections, and is suitable for matching the same account between repeated collections. Note that stability is best-effort and depends on what the institution exposes; it may occasionally change if the institution restructures or reissues the account, and the value may be masked or partially redacted (e.g., as a masked PAN for credit cards), which can cause collisions between accounts sharing the same visible digits.

transactionsArray<Transaction>

Transaction history for the last 12 months.

typestringrequired

Type of the financial product.

Possible Enum values are LIVRET.
Example
{  "classification": "LIVRET_A",  "company": "fr-hellobank",  "companyDisplayName": "hellobank",  "currentValue": {    "amount": 25455,    "currency": "EUR"  },  "deposit": {    "amount": {      "amount": 22950,      "currency": "EUR"    }  },  "holder": {    "name": "Jean Dupont"  },  "id": "6a7c135e-3a56-44ae-bc53-1d0d5321f552",  "interest": {    "effectiveRate": 0.025,    "rateConditionRanges": [      {        "maxAmount": {          "amount": 22950,          "currency": "EUR"        }      }    ]  },  "productName": "Livret A",  "productNumber": "1234567890",  "transactions": [    {      "amount": {        "amount": 1000,        "currency": "EUR"      },      "description": "Versement",      "settlementDate": "2026-01-01",      "type": "DEPOSIT"    }  ],  "type": "LIVRET"}