LElemon
Product Contracts

Get Product Contract

Changed on

Returns a single active product contract, together with the instruments eligible under it. Draft, retired and unknown contracts result in a <code>404</code> response.

get/product_contracts/{contract_id}

Request

Path parameters

contract_idstring required

A product contract identifier.

Headers

LMG-Data-Privacy-Access-Principalstring required
LMG-Data-Privacy-Access-Justificationstring required

Response

Successful Response

idstring required

The product contract identifier. Pass it as <code>contract</code> when creating a retirement product via <code>POST /accounts/{account_id}/products</code>.

type'brokerage' | 'retirement' required

The type of product a contract belongs to.

<ul> <li><code>brokerage</code>: the lemon.markets brokerage product. <li><code>retirement</code>: the lemon.markets retirement account (Altersvorsorgedepot) product. </ul>
contract_namestring required

The name of the contract.

contract_type'standarddepot' | 'self_directed' required

The type of the contract.

<ul> <li><code>standarddepot</code>: a standard depot contract. <li><code>self_directed</code>: a self-directed contract. </ul>
certification_numberstring required

The certification number of the contract.

provider_numberstring required

The number of the contract provider.

provider_namestring required

The name of the contract provider.

provider_model'external' | 'lmb' required

Who provides the contract.

<ul> <li><code>external</code>: an external provider. <li><code>lmb</code>: lemon.markets. </ul>
status'active' required

The status of the contract. Only active contracts are returned.

valid_fromstring date-time required

The time from which the contract is valid.

valid_untilstring date-time nullable required

The time until which the contract is valid, or <code>null</code> if it has no end date.

fee_annual_payin_aum_pctstring number required

The annual fee charged on assets under management, as a percentage (<code>1.00</code> is 1%) for payin phase.

fee_annual_payout_aum_pctstring number required

The annual fee charged on assets under management, as a percentage (<code>1.00</code> is 1%) for payout phase.

fee_provider_switch_amountstring number required

The one time fee for switching depot providers, in EUR.

fee_transaction_buy_amountstring number required

The fee charged per buy transaction, in EUR.

fee_transaction_sell_amountstring number required

The fee charged per sell transaction, in EUR.

Example response

{
  "id": "pcon_7d1a8c0e5b8f4f3a9c2e6b1d4f0a9e57",
  "contract_name": "Altersvorsorgedepot Standard",
  "contract_type": "standarddepot",
  "certification_number": "AVD-2026-000123",
  "provider_number": "PRV001",
  "provider_name": "Example Provider GmbH",
  "provider_model": "external",
  "status": "active",
  "valid_from": "2026-01-01T00:00:00+00:00",
  "fee_annual_payin_aum_pct": "1.00",
  "fee_annual_payout_aum_pct": "1.00",
  "fee_provider_switch_amount": "0.00",
  "fee_transaction_buy_amount": "0.00",
  "fee_transaction_sell_amount": "0.00",
  "instruments": [
    {
      "instrument": "IE00B4L5Y983",
      "risk_class": 4
    }
  ]
}

Changes