---
title: "Lister les contrats de mutuelle et de prévoyance"
description: "Liste les contrats de mutuelle et de prévoyance de l’entreprise, par libellé, avec toutes leurs versions (de la plus récente à la plus ancienne).\n\nPour une mutuelle au forfait, le code `affiliationChoice` d’une formule se passe en `mutuelleForfaitChoice`, avec `mutuelleOcContractId`, sur un contrat de travail. Les affiliations des salariés sont dans `ocAffiliations` des contrats de travail."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

Path: API Puncto › Entreprise

`GET /public/v1/oc-contracts`

Liste les contrats de mutuelle et de prévoyance de l’entreprise, par libellé, avec toutes leurs versions (de la plus récente à la plus ancienne).

Pour une mutuelle au forfait, le code `affiliationChoice` d’une formule se passe en `mutuelleForfaitChoice`, avec `mutuelleOcContractId`, sur un contrat de travail. Les affiliations des salariés sont dans `ocAffiliations` des contrats de travail.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listOcContracts.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listOcContracts.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `type[]` (`listOcContracts.query.type[]`; array<string>, optional) — Types de contrat à garder. Répétez le paramètre pour en passer plusieurs.

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.puncto.fr/public/v1/oc-contracts \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/oc-contracts';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/oc-contracts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

Page de contrats de mutuelle et de prévoyance

#### Example

```json
{
  "data": [
    {
      "ocContractId": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "label": "string",
      "type": "MUTUELLE",
      "contractTarget": "CADRE",
      "contractReference": "string",
      "versions": [
        {
          "renewalId": "ocre_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "status": "ACTIVE",
          "startDate": "2019-08-24",
          "endDate": "2019-08-24",
          "organismCode": "string",
          "delegationCode": "string",
          "populationCode": "string",
          "cotisationType": "FORFAIT",
          "periodicity": "Mensuel",
          "prorationMode": "JOURS_REELS",
          "forfaitChoices": [
            {
              "affiliationChoice": "string",
              "label": "string",
              "description": "string",
              "monthlyAmount": 0,
              "employerSharePercent": 0
            }
          ],
          "tranches": [
            {
              "tranche": "TRANCHE_A",
              "label": "string",
              "totalRate": 0,
              "employerSharePercent": 0
            }
          ]
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listOcContracts.response.200.data`; array<object>, required)
  - `ocContractId` (`listOcContracts.response.200.data.ocContractId`; string, required) — Identifiant Puncto du contrat, à passer en `mutuelleOcContractId` ou `prevoyanceOcContractId` à la création d'un contrat de travail
  - `label` (`listOcContracts.response.200.data.label`; string, required) — Libellé du contrat
  - `type` (`listOcContracts.response.200.data.type`; string, required) — Mutuelle ou prévoyance
    - one of `"MUTUELLE"`, `"PREVOYANCE"`
  - `contractTarget` (`listOcContracts.response.200.data.contractTarget`; string, required) — Salariés couverts : cadres, non-cadres ou tous
    - one of `"CADRE"`, `"NON_CADRE"`, `"ALL"`
  - `contractReference` (`listOcContracts.response.200.data.contractReference`; string, required) — Numéro du contrat chez l'organisme (S21.G00.15.001)
  - `versions` (`listOcContracts.response.200.data.versions`; array<object>, required) — Versions du contrat, de la plus récente à la plus ancienne
    - `renewalId` (`listOcContracts.response.200.data.versions.renewalId`; any of, required) — Identifiant Puncto du renouvellement, null pour la version initiale du contrat
      - any of: `string`, `null`
    - `status` (`listOcContracts.response.200.data.versions.status`; string, required) — Version en cours, à venir ou terminée
      - one of `"ACTIVE"`, `"FUTURE"`, `"PAST"`
    - `startDate` (`listOcContracts.response.200.data.versions.startDate`; string, required) — Date de début de la version
      - format `date`
    - `endDate` (`listOcContracts.response.200.data.versions.endDate`; any of, required) — Date de fin de la version, null si elle n'a pas de fin prévue
      - any of: `string`, `null`
    - `organismCode` (`listOcContracts.response.200.data.versions.organismCode`; string, required) — Code de l'organisme assureur (S21.G00.15.002)
    - `delegationCode` (`listOcContracts.response.200.data.versions.delegationCode`; string | null, required) — Code de l'organisme délégataire de gestion (S21.G00.15.003)
    - `populationCode` (`listOcContracts.response.200.data.versions.populationCode`; string | null, required) — Code population du contrat (S21.G00.70.005)
    - `cotisationType` (`listOcContracts.response.200.data.versions.cotisationType`; string, required) — Mode de cotisation : `FORFAIT` (mutuelle au forfait) ou `TRANCHES` (prévoyance par tranches)
      - one of `"FORFAIT"`, `"TRANCHES"`
    - `periodicity` (`listOcContracts.response.200.data.versions.periodicity`; string, required) — Périodicité de la cotisation
      - one of `"Mensuel"`, `"Trimestriel"`
    - `prorationMode` (`listOcContracts.response.200.data.versions.prorationMode`; any of, required) — Proratisation de la cotisation en cas d'entrée ou de sortie en cours de mois, null par tranches
      - any of: `OcProrationMode`, `null`
    - `forfaitChoices` (`listOcContracts.response.200.data.versions.forfaitChoices`; array<object>, required) — Formules proposées au salarié, vide pour une cotisation par tranches
      - `affiliationChoice` (`listOcContracts.response.200.data.versions.forfaitChoices.affiliationChoice`; string, required) — Code de la formule, à passer en `mutuelleForfaitChoice` à la création d'un contrat de travail : `UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`
      - `label` (`listOcContracts.response.200.data.versions.forfaitChoices.label`; string, required) — Libellé de la formule
      - `description` (`listOcContracts.response.200.data.versions.forfaitChoices.description`; string | null, required) — Mode de calcul de la cotisation, null pour un montant fixe (par exemple « 1,5 % du PMSS »)
      - `monthlyAmount` (`listOcContracts.response.200.data.versions.forfaitChoices.monthlyAmount`; number, required) — Cotisation mensuelle totale (part salariale et part patronale), en euros : au tarif du jour pour la version en cours, de son début pour une version à venir, de sa fin pour une version terminée
      - `employerSharePercent` (`listOcContracts.response.200.data.versions.forfaitChoices.employerSharePercent`; number, required) — Part patronale de la cotisation, en %
    - `tranches` (`listOcContracts.response.200.data.versions.tranches`; array<object>, required) — Tranches cotisées, vide pour une cotisation au forfait
      - `tranche` (`listOcContracts.response.200.data.versions.tranches.tranche`; string, required) — Tranche : `TRANCHE_A`, `TRANCHE_B` (tranche 2 en mode TA/T2U) ou `TRANCHE_C`
        - one of `"TRANCHE_A"`, `"TRANCHE_B"`, `"TRANCHE_C"`
      - `label` (`listOcContracts.response.200.data.versions.tranches.label`; string, required) — Libellé de la tranche
      - `totalRate` (`listOcContracts.response.200.data.versions.tranches.totalRate`; number, required) — Taux de cotisation total (part salariale et part patronale), en % du salaire de la tranche
      - `employerSharePercent` (`listOcContracts.response.200.data.versions.tranches.employerSharePercent`; number, required) — Part patronale de la cotisation, en %
  - `createdAt` (`listOcContracts.response.200.data.createdAt`; string, required) — Date d'enregistrement du contrat dans Puncto
    - format `date-time`
  - `updatedAt` (`listOcContracts.response.200.data.updatedAt`; string, required) — Date de dernière modification du contrat (hors renouvellements)
    - format `date-time`
- `meta` (`listOcContracts.response.200.meta`; object, required)
  - `total` (`listOcContracts.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listOcContracts.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listOcContracts.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listOcContracts.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listOcContracts.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listOcContracts.response.200.meta.lastPage`; integer, required)

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`listOcContracts.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listOcContracts.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`listOcContracts.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listOcContracts.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 422

Paramètres invalides

#### Example

```json
{
  "errors": [
    {
      "message": "Le champ statut de l’absence doit être une valeur autorisée",
      "rule": "enum",
      "field": "status"
    }
  ]
}
```

- `errors` (`listOcContracts.response.422.errors`; array<object>, required)
  - `message` (`listOcContracts.response.422.errors.message`; string, required)
  - `rule` (`listOcContracts.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`listOcContracts.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/oc-contracts/list/index.md
