---
url: /topics/start-building/premium.md
---
# Premium

The premium resource covers all payment data associated with a life insurance contract. Two types of premium payments are supported. In both cases, the API call must include the `payer` details and the allocation under Self-Invested management mode.

## Single premium request (versement libre)

A one-off, discretionary payment made at any time by the policyholder. The amount and allocation are defined at the time of the request.

```ts
// code API
```

## Recurring premium request (versement programmé)

A scheduled payment set up at a defined frequency (monthly, quarterly, annually). The payer and allocation are configured once and applied automatically at each occurrence.

::: tip
Multiple recurring premiums can coexist on the same contract — each with its own payer, frequency, amount, and allocation.
:::

```ts
// code API
```