---
title: "Lister les contrats"
description: "Liste paginée des contrats de l’entreprise, terminés, à venir et en cours de création compris. Tri par date de début (sans date en dernier), puis par identifiant."
---

> 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 › Contrats

`GET /public/v1/contracts`

Liste paginée des contrats de l’entreprise, terminés, à venir et en cours de création compris. Tri par date de début (sans date en dernier), puis par identifiant.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listContracts.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listContracts.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `collaboratorId` (`listContracts.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listContracts.query.collaboratorForeignErpId`; string, optional) — Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.
  - example `"salarie-123"`
- `workerType[]` (`listContracts.query.workerType[]`; array<string>, optional) — Types de contrat à garder. Répétez le paramètre pour en passer plusieurs.
- `activationStatus[]` (`listContracts.query.activationStatus[]`; array<string>, optional) — Statuts de contrat à garder. Répétez le paramètre pour en passer plusieurs.
- `activeAt` (`listContracts.query.activeAt`; string, optional) — Contrats en cours à cette date : commencés au plus tard ce jour, sans fin ou finissant au plus tôt ce jour.
  - format `date`; example `"2026-10-01"`
- `referenceDate` (`listContracts.query.referenceDate`; string, optional) — Date de résolution de `currentAmendment` et `establishmentId`. Par défaut, aujourd’hui, ou la date de début d’un contrat pas encore commencé.
  - format `date`; example `"2026-10-01"`

## Code samples

### cURL

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

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/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/contracts"

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

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

print(response.text)
```

## Responses

### 200

Page de contrats

#### Example

```json
{
  "data": [
    {
      "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorForeignErpId": "string",
      "dsnContractNumber": "string",
      "workerType": "EMPLOYEE_CDI",
      "activationStatus": "C_INVITATION_SENT",
      "startDate": "2019-08-24",
      "endDate": "2019-08-24",
      "cddMotifRecours": "01",
      "dpaeDoneByPuncto": true,
      "hasMutuelleDispense": true,
      "corporateOfficerSalaryMaintenance": true,
      "publicTransportEmployerRate": 0,
      "internshipStudies": "string",
      "internshipSchool": "string",
      "internshipPaidLeaveDays": 0,
      "apprenticeshipFormationLevel": "03",
      "apprenticeshipFormationYearsPeriods": {
        "FIRST_YEAR": {
          "startDate": "2019-08-24",
          "endDate": "2019-08-24"
        },
        "SECOND_YEAR": {
          "startDate": "2019-08-24",
          "endDate": "2019-08-24"
        },
        "THIRD_YEAR": {
          "startDate": "2019-08-24",
          "endDate": "2019-08-24"
        }
      },
      "referenceDate": "2019-08-24",
      "establishmentId": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "currentAmendment": {
        "remunerationBasis": "ANNUAL",
        "grossAnnualSalary": 0,
        "hourlyRate": 0,
        "smoothedMonthlyAmount": 0,
        "smoothingPlannedHours": 0,
        "remunerationPercentage": 0,
        "remunerationReference": "SMIC",
        "id": "came_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "companyRoleId": "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "companyTeamId": "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "establishmentId": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "startDate": "2019-08-24",
        "renewsCddTerm": true,
        "postponesCddTerm": true,
        "previousCddEndDate": "2019-08-24",
        "isCadre": true,
        "mealVoucherStatus": "DEFAULT",
        "remoteWorkAllowanceStatus": "DEFAULT",
        "remoteWorkWeeklyDays": 0,
        "mealAllowanceType": "ON_SITE",
        "quotity": {
          "type": "HEURE",
          "monthlyWorkingHours": 0,
          "workingPercentage": 0,
          "paidContractualOvertimeHours": 0,
          "rttContractualOvertimeHours": 0,
          "rcrContractualOvertimeHours": 0,
          "isCeilingProrated": true
        },
        "workerOutsideFranceStatus": "01",
        "workPlace": {
          "address": "string",
          "addressDetails": "string",
          "postalCode": "string",
          "city": "string",
          "countryCode": "FR",
          "inseeCode": "string"
        },
        "workTerritory": "METROPOLE",
        "conventionalWorkerStatus": "01",
        "conventionalPosition": {
          "type": "CADRE",
          "position": "1.1"
        },
        "weekDaysWorked": 0,
        "workSchedule": {
          "version": 1,
          "days": {
            "MONDAY": {
              "morning": {},
              "afternoon": {}
            },
            "TUESDAY": {
              "morning": {},
              "afternoon": {}
            },
            "WEDNESDAY": {
              "morning": {},
              "afternoon": {}
            },
            "THURSDAY": {
              "morning": {},
              "afternoon": {}
            },
            "FRIDAY": {
              "morning": {},
              "afternoon": {}
            },
            "SATURDAY": {
              "morning": {},
              "afternoon": {}
            },
            "SUNDAY": {
              "morning": {},
              "afternoon": {}
            }
          }
        },
        "codePcsEse": "100x",
        "applyJeiExoneration": true,
        "applyAcreExoneration": true,
        "apprenticeshipFormationYear": "FIRST_YEAR"
      },
      "amendments": [
        {
          "remunerationBasis": "ANNUAL",
          "grossAnnualSalary": 0,
          "hourlyRate": 0,
          "smoothedMonthlyAmount": 0,
          "smoothingPlannedHours": 0,
          "remunerationPercentage": 0,
          "remunerationReference": "SMIC",
          "id": "came_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "companyRoleId": "crol_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "companyTeamId": "ctea_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "establishmentId": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "startDate": "2019-08-24",
          "renewsCddTerm": true,
          "postponesCddTerm": true,
          "previousCddEndDate": "2019-08-24",
          "isCadre": true,
          "mealVoucherStatus": "DEFAULT",
          "remoteWorkAllowanceStatus": "DEFAULT",
          "remoteWorkWeeklyDays": 0,
          "mealAllowanceType": "ON_SITE",
          "quotity": {
            "type": "HEURE",
            "monthlyWorkingHours": 0,
            "workingPercentage": 0,
            "paidContractualOvertimeHours": 0,
            "rttContractualOvertimeHours": 0,
            "rcrContractualOvertimeHours": 0,
            "isCeilingProrated": true
          },
          "workerOutsideFranceStatus": "01",
          "workPlace": {
            "address": "string",
            "addressDetails": "string",
            "postalCode": "string",
            "city": "string",
            "countryCode": "FR",
            "inseeCode": "string"
          },
          "workTerritory": "METROPOLE",
          "conventionalWorkerStatus": "01",
          "conventionalPosition": {
            "type": "CADRE",
            "position": "1.1"
          },
          "weekDaysWorked": 0,
          "workSchedule": {
            "version": 1,
            "days": {
              "MONDAY": {},
              "TUESDAY": {},
              "WEDNESDAY": {},
              "THURSDAY": {},
              "FRIDAY": {},
              "SATURDAY": {},
              "SUNDAY": {}
            }
          },
          "codePcsEse": "100x",
          "applyJeiExoneration": true,
          "applyAcreExoneration": true,
          "apprenticeshipFormationYear": "FIRST_YEAR"
        }
      ],
      "trialPeriods": [
        {
          "id": "ctpe_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "type": "initial",
          "initialEndDate": "2019-08-24",
          "recalculatedEndDate": "2019-08-24",
          "recalculationDate": "2019-08-24T14:15:22Z",
          "validationDate": "2019-08-24",
          "notificationSentAt": "2019-08-24T14:15:22Z",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      ],
      "endOfContract": {
        "endOfContractId": "eoco_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "endDate": "2019-08-24",
        "lastWorkedDay": "2019-08-24",
        "finalSettlementPayrollDate": "2019-08-24",
        "terminationReason": "011",
        "terminationInitiator": "COMPANY",
        "notificationDate": "2019-08-24",
        "layoffProcedureStartDate": "2019-08-24",
        "terminationAgreementSignatureDate": "2019-08-24",
        "plannedEndDate": "2019-08-24",
        "noticePeriodType": "01",
        "noticeSituation": "EMPLOYER_WAIVER",
        "noticePeriodStartDate": "2019-08-24",
        "noticePeriodEndDate": "2019-08-24",
        "permanentContractOutcome": "NONE",
        "precarityBonusDue": true,
        "leaveCarriedOver": true,
        "dismissalIndemnityAmount": 0,
        "finalSettlementPaymentDate": "2019-08-24",
        "mutuellePortability": true,
        "prevoyancePortability": true,
        "finalSettlementPayslipId": "pays_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "finalSettlementReceiptFileId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "workCertificateFileId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z"
      },
      "ocAffiliations": [
        {
          "ocAffiliationId": "ocaf_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "ocContractId": "ocon_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "type": "MUTUELLE",
          "ocContractLabel": "string",
          "startDate": "2019-08-24",
          "endDate": "2019-08-24",
          "affiliationChoice": "string",
          "forfaitLabel": "string"
        }
      ],
      "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` (`listContracts.response.200.data`; array<object>, required)
  - `contractId` (`listContracts.response.200.data.contractId`; string, required) — Identifiant Puncto du contrat
  - `collaboratorId` (`listContracts.response.200.data.collaboratorId`; string, required) — Identifiant Puncto du collaborateur
  - `collaboratorForeignErpId` (`listContracts.response.200.data.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
  - `dsnContractNumber` (`listContracts.response.200.data.dsnContractNumber`; string, required) — Numéro du contrat déclaré en DSN (S21.G00.40.009)
  - `workerType` (`listContracts.response.200.data.workerType`; any of, required) — Type de contrat, null pour un contrat en cours de création
    - any of: `WorkerType`, `null`
  - `activationStatus` (`listContracts.response.200.data.activationStatus`; string, required) — Statut du contrat dans Puncto
    - one of `"C_INVITATION_SENT"`, `"A_TO_BE_REALIZED"`, `"B_ACTION_NEEDED"`, `"E_ARCHIVED"`, `"D_ACTIVE"`, `"F_TO_CLOSE"`, `"G_UPCOMING"`
  - `startDate` (`listContracts.response.200.data.startDate`; any of, required) — Date de début du contrat, null pour un contrat en cours de création
    - any of: `string`, `null`
  - `endDate` (`listContracts.response.200.data.endDate`; any of, required) — Date de fin du contrat : terme prévu (CDD, stage, alternance, mandat), remplacé par la date de fin effective une fois le contrat clôturé. Null pour un contrat sans terme.
    - any of: `string`, `null`
  - `cddMotifRecours` (`listContracts.response.200.data.cddMotifRecours`; any of, required) — CDD : motif de recours déclaré en DSN (S21.G00.40.021)
    - any of: `DsnMotifRecours`, `null`
  - `dpaeDoneByPuncto` (`listContracts.response.200.data.dpaeDoneByPuncto`; boolean, required) — La DPAE du contrat est effectuée par Puncto
  - `hasMutuelleDispense` (`listContracts.response.200.data.hasMutuelleDispense`; boolean, required) — Le salarié est dispensé d'adhésion à la mutuelle
  - `corporateOfficerSalaryMaintenance` (`listContracts.response.200.data.corporateOfficerSalaryMaintenance`; boolean, required) — Mandataire social : rémunération maintenue pendant les arrêts, sous déduction des IJSS
  - `publicTransportEmployerRate` (`listContracts.response.200.data.publicTransportEmployerRate`; number | null, required) — Taux de prise en charge employeur (%) des abonnements de transport en commun propre au contrat, null quand les taux de l'établissement s'appliquent
  - `internshipStudies` (`listContracts.response.200.data.internshipStudies`; string | null, required) — Stage : formation suivie
  - `internshipSchool` (`listContracts.response.200.data.internshipSchool`; string | null, required) — Stage : établissement d'enseignement
  - `internshipPaidLeaveDays` (`listContracts.response.200.data.internshipPaidLeaveDays`; number | null, required) — Stage : forfait de jours de congés payés accordés, null s'il n'est pas accordé
  - `apprenticeshipFormationLevel` (`listContracts.response.200.data.apprenticeshipFormationLevel`; any of, required) — Alternance : niveau du diplôme préparé
    - any of: `ApprenticeshipFormationLevel`, `null`
  - `apprenticeshipFormationYearsPeriods` (`listContracts.response.200.data.apprenticeshipFormationYearsPeriods`; any of, required) — Alternance : périodes des années de formation
    - any of: `ApprenticeshipFormationYearsPeriods`, `null`
  - `referenceDate` (`listContracts.response.200.data.referenceDate`; string, required) — Date à laquelle `currentAmendment` et `establishmentId` sont résolus : la date demandée, sinon la date du jour (la date de début pour un contrat qui n'a pas encore commencé)
    - format `date`
  - `establishmentId` (`listContracts.response.200.data.establishmentId`; string, required) — Établissement de rattachement en vigueur à `referenceDate` (avant le premier avenant : celui du premier avenant)
  - `currentAmendment` (`listContracts.response.200.data.currentAmendment`; any of, required) — Avenant en vigueur à `referenceDate`, null avant le premier avenant
    - any of: `ApiContractAmendment`, `null`
  - `amendments` (`listContracts.response.200.data.amendments`; array<object>, required) — Tous les avenants du contrat, avenants à venir compris, du plus ancien au plus récent
    - `remunerationBasis` (`listContracts.response.200.data.amendments.remunerationBasis`; string, required)
      - one of `"ANNUAL"`, `"HOURLY"`, `"SMOOTHED_MONTHLY"`, `"PERCENTAGE"`
    - `grossAnnualSalary` (`listContracts.response.200.data.amendments.grossAnnualSalary`; number | null, required) — `ANNUAL` : salaire brut annuel.
    - `hourlyRate` (`listContracts.response.200.data.amendments.hourlyRate`; number | null, required) — `HOURLY` : taux horaire brut. `SMOOTHED_MONTHLY` : taux horaire contractuel, figé au début de la période de lissage.
    - `smoothedMonthlyAmount` (`listContracts.response.200.data.amendments.smoothedMonthlyAmount`; number | null, required) — `SMOOTHED_MONTHLY` : montant mensuel lissé.
    - `smoothingPlannedHours` (`listContracts.response.200.data.amendments.smoothingPlannedHours`; number | null, required) — `SMOOTHED_MONTHLY` : heures prévues de la période de lissage, figées à son début.
    - `remunerationPercentage` (`listContracts.response.200.data.amendments.remunerationPercentage`; number | null, required) — `PERCENTAGE` : pourcentage de la référence, ex. `53` pour 53 %.
    - `remunerationReference` (`listContracts.response.200.data.amendments.remunerationReference`; any of, required) — `PERCENTAGE` : référence du pourcentage.
      - any of: `RemunerationReference`, `null`
    - `id` (`listContracts.response.200.data.amendments.id`; string, required) — Identifiant Puncto
    - `companyRoleId` (`listContracts.response.200.data.amendments.companyRoleId`; any of, required)
      - any of: `string`, `null`
    - `companyTeamId` (`listContracts.response.200.data.amendments.companyTeamId`; any of, required)
      - any of: `string`, `null`
    - `establishmentId` (`listContracts.response.200.data.amendments.establishmentId`; string, required) — Identifiant Puncto
    - `startDate` (`listContracts.response.200.data.amendments.startDate`; string, required)
      - format `date`
    - `renewsCddTerm` (`listContracts.response.200.data.amendments.renewsCddTerm`; boolean, required)
    - `postponesCddTerm` (`listContracts.response.200.data.amendments.postponesCddTerm`; boolean, required)
    - `previousCddEndDate` (`listContracts.response.200.data.amendments.previousCddEndDate`; any of, required)
      - any of: `string`, `null`
    - `isCadre` (`listContracts.response.200.data.amendments.isCadre`; boolean, required)
    - `mealVoucherStatus` (`listContracts.response.200.data.amendments.mealVoucherStatus`; string, required)
      - one of `"DEFAULT"`, `"DISABLED"`
    - `remoteWorkAllowanceStatus` (`listContracts.response.200.data.amendments.remoteWorkAllowanceStatus`; string, required)
      - one of `"DEFAULT"`, `"DISABLED"`
    - `remoteWorkWeeklyDays` (`listContracts.response.200.data.amendments.remoteWorkWeeklyDays`; number | null, required) — Nombre de jours de télétravail par semaine prévus au contrat.
    - `mealAllowanceType` (`listContracts.response.200.data.amendments.mealAllowanceType`; any of, required) — Type de prime de panier versée au titre du contrat. `null` = pas de prime de panier.
      - any of: `MealAllowanceType`, `null`
    - `quotity` (`listContracts.response.200.data.amendments.quotity`; any of, required)
      - any of: `object`, `object`, `object`, `object`
    - `workerOutsideFranceStatus` (`listContracts.response.200.data.amendments.workerOutsideFranceStatus`; string, required)
      - one of `"01"`, `"02"`, `"03"`, `"99"`
    - `workPlace` (`listContracts.response.200.data.amendments.workPlace`; any of, required) — Lieu de travail effectif, quand il diffère de l'établissement de rattachement.
      - any of: `ContractWorkPlace`, `null`
    - `workTerritory` (`listContracts.response.200.data.amendments.workTerritory`; string, required) — Territoire du lieu de travail effectif, déduit de `workPlace` ou à défaut de l'adresse de l'établissement : il détermine les jours fériés applicables.
      - one of `"METROPOLE"`, `"ALSACE_MOSELLE"`, `"GUADELOUPE"`, `"MARTINIQUE"`, `"GUYANE"`, `"REUNION"`, `"MAYOTTE"`
    - `conventionalWorkerStatus` (`listContracts.response.200.data.amendments.conventionalWorkerStatus`; string, required)
      - one of `"01"`, `"02"`, `"03"`, `"04"`, `"05"`, `"06"`, `"07"`, `"08"`, `"09"`, `"10"`
    - `conventionalPosition` (`listContracts.response.200.data.amendments.conventionalPosition`; any of, required)
      - any of: `SyntecPosition`, `null`
    - `weekDaysWorked` (`listContracts.response.200.data.amendments.weekDaysWorked`; number, required) — Bitset des jours travaillés, dérivé de `workSchedule` (voir `week_days.ts`).
    - `workSchedule` (`listContracts.response.200.data.amendments.workSchedule`; object, required) — Planning type de l'avenant : jours seuls ou horaire (voir `work_schedule.ts`).
      - `version` (`listContracts.response.200.data.amendments.workSchedule.version`; number, required)
      - `days` (`listContracts.response.200.data.amendments.workSchedule.days`; object, required) — Un jour absent de la carte n'est pas travaillé.
        - `MONDAY` (`listContracts.response.200.data.amendments.workSchedule.days.MONDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.MONDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.MONDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `TUESDAY` (`listContracts.response.200.data.amendments.workSchedule.days.TUESDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.TUESDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.TUESDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `WEDNESDAY` (`listContracts.response.200.data.amendments.workSchedule.days.WEDNESDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.WEDNESDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.WEDNESDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `THURSDAY` (`listContracts.response.200.data.amendments.workSchedule.days.THURSDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.THURSDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.THURSDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `FRIDAY` (`listContracts.response.200.data.amendments.workSchedule.days.FRIDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.FRIDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.FRIDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `SATURDAY` (`listContracts.response.200.data.amendments.workSchedule.days.SATURDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.SATURDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.SATURDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
        - `SUNDAY` (`listContracts.response.200.data.amendments.workSchedule.days.SUNDAY`; object, optional)
          - `morning` (`listContracts.response.200.data.amendments.workSchedule.days.SUNDAY.morning`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
          - `afternoon` (`listContracts.response.200.data.amendments.workSchedule.days.SUNDAY.afternoon`; any of, required)
            - any of: `WorkScheduleTimeRange`, `null`
    - `codePcsEse` (`listContracts.response.200.data.amendments.codePcsEse`; any of, required)
      - any of: `CodePcsEse`, `null`
    - `applyJeiExoneration` (`listContracts.response.200.data.amendments.applyJeiExoneration`; boolean, required)
    - `applyAcreExoneration` (`listContracts.response.200.data.amendments.applyAcreExoneration`; boolean, required) — ACRE du dirigeant assimilé salarié : exonération salariale et patronale 12 mois.
    - `apprenticeshipFormationYear` (`listContracts.response.200.data.amendments.apprenticeshipFormationYear`; any of, required) — Année de formation couverte par l'avenant (alternance uniquement).
      - any of: `ApprenticeshipFormationYear`, `null`
  - `trialPeriods` (`listContracts.response.200.data.trialPeriods`; array<object>, required) — Périodes d'essai (initiale puis renouvellement), par date de fin croissante
    - `id` (`listContracts.response.200.data.trialPeriods.id`; string, required) — Identifiant Puncto de la période d'essai
    - `type` (`listContracts.response.200.data.trialPeriods.type`; string, required) — Période initiale ou renouvellement
      - one of `"initial"`, `"renewal"`
    - `initialEndDate` (`listContracts.response.200.data.trialPeriods.initialEndDate`; string, required) — Fin nominale : celle prévue au contrat, ou choisie au renouvellement
      - format `date`
    - `recalculatedEndDate` (`listContracts.response.200.data.trialPeriods.recalculatedEndDate`; any of, required) — Fin prolongée des absences validées, ou date de la validation anticipée ; null avant le premier recalcul
      - any of: `string`, `null`
    - `recalculationDate` (`listContracts.response.200.data.trialPeriods.recalculationDate`; any of, required) — Date du dernier recalcul de la fin
      - any of: `string`, `null`
    - `validationDate` (`listContracts.response.200.data.trialPeriods.validationDate`; any of, required) — Date de validation anticipée par l'employeur, null tant que la période n'est pas validée.
      - any of: `string`, `null`
    - `notificationSentAt` (`listContracts.response.200.data.trialPeriods.notificationSentAt`; any of, required) — Date d'envoi du rappel de fin de période d'essai à l'entreprise
      - any of: `string`, `null`
    - `createdAt` (`listContracts.response.200.data.trialPeriods.createdAt`; string, required) — Date d'enregistrement de la période dans Puncto
      - format `date-time`
  - `endOfContract` (`listContracts.response.200.data.endOfContract`; any of, required) — Clôture du contrat, null tant que le contrat n'est pas clôturé
    - any of: `PublicApiEndOfContract`, `null`
  - `ocAffiliations` (`listContracts.response.200.data.ocAffiliations`; array<object>, required) — Affiliations mutuelle et prévoyance du contrat, par date de début croissante
    - `ocAffiliationId` (`listContracts.response.200.data.ocAffiliations.ocAffiliationId`; string, required) — Identifiant Puncto de l'affiliation
    - `ocContractId` (`listContracts.response.200.data.ocAffiliations.ocContractId`; string, required) — Contrat de mutuelle ou de prévoyance de l'entreprise auquel le salarié est affilié
    - `type` (`listContracts.response.200.data.ocAffiliations.type`; string, required) — Mutuelle ou prévoyance
      - one of `"MUTUELLE"`, `"PREVOYANCE"`
    - `ocContractLabel` (`listContracts.response.200.data.ocAffiliations.ocContractLabel`; string, required) — Libellé du contrat de mutuelle ou de prévoyance
    - `startDate` (`listContracts.response.200.data.ocAffiliations.startDate`; string, required) — Date de début de l'affiliation
      - format `date`
    - `endDate` (`listContracts.response.200.data.ocAffiliations.endDate`; any of, required) — Date de fin de l'affiliation, null si elle n'a pas de fin prévue
      - any of: `string`, `null`
    - `affiliationChoice` (`listContracts.response.200.data.ocAffiliations.affiliationChoice`; string | null, required) — Formule de mutuelle choisie parmi celles du contrat : `UNIQUE`, `OPTION_<code>`, `CONDITION_<code>` ou, quand plusieurs forfaits partagent une option, `TIER_<code>__<libellé>`. Null sans formule (prévoyance notamment).
    - `forfaitLabel` (`listContracts.response.200.data.ocAffiliations.forfaitLabel`; string | null, required) — Libellé de la formule choisie (à défaut, son code), null sans formule
  - `createdAt` (`listContracts.response.200.data.createdAt`; string, required) — Date de création du contrat dans Puncto
    - format `date-time`
  - `updatedAt` (`listContracts.response.200.data.updatedAt`; string, required) — Date de dernière modification du contrat (hors avenants, périodes d'essai et clôture)
    - format `date-time`
- `meta` (`listContracts.response.200.meta`; object, required)
  - `total` (`listContracts.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listContracts.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listContracts.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listContracts.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listContracts.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listContracts.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` (`listContracts.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listContracts.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` (`listContracts.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listContracts.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Aucun collaborateur ne correspond au filtre

#### Example

```json
{
  "error": "Collaborateur non trouvé"
}
```

- `error` (`listContracts.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`listContracts.response.404.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` (`listContracts.response.422.errors`; array<object>, required)
  - `message` (`listContracts.response.422.errors.message`; string, required)
  - `rule` (`listContracts.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`listContracts.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


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