REST API Reference
Financial Value
Product Current Values
List Product Current ValuesgetGet Product Current Valueget
Financial History
Get Account Financial HistorygetGet Product Financial Historyget
Invest Profile Category Performance
Get Invest Profile Category Performance Historyget

REST API Reference

Updated on March 9, 2026

The Mon Petit Placement REST API offers access and control over all Mon Petit Placement data.

While integrating the REST API, you may be interested in the following guides:

Product Current Valuesin Financial Value

List Product Current Values

GET
//v1/user_investment_accounts/{uia_id}/products_current_values{?investmentCompartment,page,limit}

Returns all current product values for a user investment account, with optional compartment filtering.

URI Parameters
uia_id
stringRequired

The user investment account identifier (UUID)

investmentCompartment
enum[string]Optional

Filter by investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
page
stringOptional

Page number

limit
stringOptional

Number of items per page

Response Data
hydra:member
array[object]

Collection of product account values

amount
number

Current value in euros

investedAmount
number

Total invested amount in euros

repurchaseAmount
number

Total repurchased amount in euros

securityUnits
numberOptional

Number of security units held

averageAcquisitionAmount
numberOptional

Average acquisition price per unit in euros

performance
number

Performance as a percentage

investmentCompartment
enum[string]

Investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
date
string

Valuation date (ISO 8601)

userInvestmentAccount
string

IRI of the user investment account

product
object

The product

name
string

Product name

slug
string

Product slug

investProfileCategories
array[string]

IRIs of the associated invest profile categories

hydra:totalItems
number

Total number of items

  • GEThttps://api.monpetitplacement.fr//v1/user_investment_accounts/uia_id/products_current_values
HTTP
Request
(loading)
Response
(loading)

Get Product Current Value

GET
//v1/user_investment_accounts/{uia_id}/products/{product_id}/investment_compartments/{compartment}/current_value

Returns the current value of a specific product in a given investment compartment for a user investment account.

URI Parameters
uia_id
stringRequired

The user investment account identifier (UUID)

product_id
stringRequired

The product identifier (UUID)

compartment
enum[string]Required

The investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
Response Data
amount
number

Current value in euros

investedAmount
number

Total invested amount in euros

repurchaseAmount
number

Total repurchased amount in euros

securityUnits
numberOptional

Number of security units held

averageAcquisitionAmount
numberOptional

Average acquisition price per unit in euros

performance
number

Performance as a percentage

investmentCompartment
enum[string]

Investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
date
string

Valuation date (ISO 8601)

userInvestmentAccount
string

IRI of the user investment account

product
object

The product

name
string

Product name

slug
string

Product slug

investProfileCategories
array[string]

IRIs of the associated invest profile categories

  • GEThttps://api.monpetitplacement.fr//v1/user_investment_accounts/uia_id/products/product_id/investment_compartments/compartment/current_value
HTTP
Request
(loading)
Response
(loading)

Financial Historyin Financial Value

Get Account Financial History

GET
//v1/user_investment_accounts/{uia_id}/financial_history{?periodStart,periodEnd}

Returns the financial history of a user investment account over a specified period, including performance and gain data.

URI Parameters
uia_id
stringRequired

The user investment account identifier (UUID)

periodStart
stringOptional

Start date inclusive (YYYY-MM-DD). Defaults to contract subscription date.

periodEnd
stringOptional

End date inclusive (YYYY-MM-DD). Defaults to current date.

Response Data
periodStart
string

Period start date (YYYY-MM-DD)

periodEnd
string

Period end date (YYYY-MM-DD)

granularity
enum[string]

Data granularity

Values

  • daily
financialValues
array[object]

Financial value snapshots

date
string

Snapshot date (YYYY-MM-DD)

amount
number

Account value in euros

investedAmount
number

Invested amount in euros

repurchasedAmount
number

Repurchased amount in euros

performance
number

Performance as a percentage

gain
number

Gain in euros

  • GEThttps://api.monpetitplacement.fr//v1/user_investment_accounts/uia_id/financial_history
HTTP
Request
(loading)
Response
(loading)

Get Product Financial History

GET
//v1/user_investment_accounts/{uia_id}/products/{product_id}/financial_history{?periodStart,periodEnd,investmentCompartment}

Returns the financial history of a specific product in a user investment account, with optional compartment filtering.

URI Parameters
uia_id
stringRequired

The user investment account identifier (UUID)

product_id
stringRequired

The product identifier (UUID)

periodStart
stringOptional

Start date inclusive (YYYY-MM-DD). Defaults to contract subscription date.

periodEnd
stringOptional

End date inclusive (YYYY-MM-DD). Defaults to current date.

investmentCompartment
enum[string]Optional

Filter by investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
Response Data
periodStart
string

Period start date (YYYY-MM-DD)

periodEnd
string

Period end date (YYYY-MM-DD)

granularity
enum[string]

Data granularity

Values

  • daily
product
string

IRI of the product

financialValues
array[object]

Financial value snapshots

date
string

Snapshot date (YYYY-MM-DD)

amount
number

Product value in euros

investedAmount
number

Invested amount in euros

repurchasedAmount
number

Repurchased amount in euros

performance
number

Performance as a percentage

gain
number

Gain in euros

investmentCompartment
enum[string]Optional

Investment compartment

Values

  • default
  • c1
  • c1-bis
  • c2
  • c3
  • GEThttps://api.monpetitplacement.fr//v1/user_investment_accounts/uia_id/products/product_id/financial_history
HTTP
Request
(loading)
Response
(loading)

Invest Profile Category Performancein Financial Value

Get Invest Profile Category Performance History

GET
//v1/invest_profile_performances/{category_slug}/{pct_id}{?start}

Returns the performance history for an invest profile category. This is a public endpoint (no authentication required). Responses are cached for 1 hour.

URI Parameters
category_slug
stringRequired

The invest profile category slug

pct_id
stringRequired

The provider contract type identifier

start
stringOptional

Start date of the period (YYYY-MM-DD)

Response Data
investProfileCategory
string

IRI of the invest profile category

providerContractType
string

IRI of the provider contract type

history
array[object]

Performance history entries

date
string

Entry date (ISO 8601)

performance
number

Performance as a percentage

investProfile
string

IRI of the invest profile

  • GEThttps://api.monpetitplacement.fr//v1/invest_profile_performances/category_slug/pct_id
HTTP
Request
(loading)
Response
(loading)