Financial Product TypeSavings

FR · Wealth API · 2026-04-01

FrenchLivret

Savings · Covers Livret A, LDDS, LEP, CEL, PEL, Livret Jeune, compte sur livret. All product types

French Livret (regulated savings account)

classificationstring

Classification of a French livret (regulated savings account).

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

Company where the financial product has been collected from. Example: fr-hello-bank.

companyDisplayNamestring

Display name of the company for user-friendly presentation.

currentValueMonetaryAmount
idstring

Unique identifier generated 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.

productNamestring

Name of the financial product.

productNumberstring

The product number assigned by the source financial institution (e.g., ISK account number, policy number, mortgage number). This is the most stable identifier for the product over time and across collections, and is suitable for matching the same product 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 product.

transactionsArray<Transaction>

Transaction history for the last 12 months.

typestringrequired

Type of the financial product.

Possible Enum values are FRENCH_PENSION, FRENCH_INVESTMENT, LIFE_INSURANCE, FRENCH_PUBLIC_PENSION, LIVRET or FRENCH_CAREER_STATEMENT.
Example
{  "classification": "LIVRET_A",  "company": "fr-hello-bank",  "companyDisplayName": "Hello Bank",  "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"}