---
title: "Consulter la période d’essai"
description: "Renvoie la période d’essai du contrat (initiale et renouvellement éventuel), sa fin effective et si elle peut être renouvelée, avec la date de fin maximale du renouvellement.\n\nLa fin effective est prolongée par les absences validées (recalcul chaque nuit) ou avancée par une validation anticipée. Sans période d’essai (stage, mandat social, période non renseignée), la liste est vide et la raison de l’impossibilité de renouveler est donnée."
---

> 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/{contractId}/trial-period`

Renvoie la période d’essai du contrat (initiale et renouvellement éventuel), sa fin effective et si elle peut être renouvelée, avec la date de fin maximale du renouvellement.

La fin effective est prolongée par les absences validées (recalcul chaque nuit) ou avancée par une validation anticipée. Sans période d’essai (stage, mandat social, période non renseignée), la liste est vide et la raison de l’impossibilité de renouveler est donnée.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `contractId` (`getContractTrialPeriod.path.contractId`; string, required) — Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.
  - example `"cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Période d’essai du contrat

#### Example

```json
{
  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorForeignErpId": "string",
  "workerType": "EMPLOYEE_CDI",
  "contractStartDate": "2019-08-24",
  "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"
    }
  ],
  "endDate": "2019-08-24",
  "validationDate": "2019-08-24",
  "isRenewed": true,
  "isOver": true,
  "renewal": {
    "isPossible": true,
    "refusalReason": "string",
    "maxEndDate": "2019-08-24",
    "projectedEndDate": "2019-08-24"
  }
}
```

- `contractId` (`getContractTrialPeriod.response.200.contractId`; string, required) — Identifiant Puncto du contrat
- `collaboratorId` (`getContractTrialPeriod.response.200.collaboratorId`; string, required) — Identifiant Puncto du collaborateur
- `collaboratorForeignErpId` (`getContractTrialPeriod.response.200.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
- `workerType` (`getContractTrialPeriod.response.200.workerType`; any of, required) — Type de contrat, null pour un contrat en cours de création
  - any of: `WorkerType`, `null`
- `contractStartDate` (`getContractTrialPeriod.response.200.contractStartDate`; any of, required) — Date de début du contrat, null pour un contrat en cours de création
  - any of: `string`, `null`
- `trialPeriods` (`getContractTrialPeriod.response.200.trialPeriods`; array<object>, required) — Périodes d'essai du contrat (initiale puis renouvellement), par date de fin croissante ; vide sans période d'essai
  - `id` (`getContractTrialPeriod.response.200.trialPeriods.id`; string, required) — Identifiant Puncto de la période d'essai
  - `type` (`getContractTrialPeriod.response.200.trialPeriods.type`; string, required) — Période initiale ou renouvellement
    - one of `"initial"`, `"renewal"`
  - `initialEndDate` (`getContractTrialPeriod.response.200.trialPeriods.initialEndDate`; string, required) — Fin nominale : celle prévue au contrat, ou choisie au renouvellement
    - format `date`
  - `recalculatedEndDate` (`getContractTrialPeriod.response.200.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` (`getContractTrialPeriod.response.200.trialPeriods.recalculationDate`; any of, required) — Date du dernier recalcul de la fin
    - any of: `string`, `null`
  - `validationDate` (`getContractTrialPeriod.response.200.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` (`getContractTrialPeriod.response.200.trialPeriods.notificationSentAt`; any of, required) — Date d'envoi du rappel de fin de période d'essai à l'entreprise
    - any of: `string`, `null`
  - `createdAt` (`getContractTrialPeriod.response.200.trialPeriods.createdAt`; string, required) — Date d'enregistrement de la période dans Puncto
    - format `date-time`
- `endDate` (`getContractTrialPeriod.response.200.endDate`; any of, required) — Fin effective de la période d'essai : celle de la dernière période, prolongée des absences ou avancée par une validation anticipée. Null sans période d'essai.
  - any of: `string`, `null`
- `validationDate` (`getContractTrialPeriod.response.200.validationDate`; any of, required) — Date de la validation anticipée de la dernière période, null si elle n'a pas été validée
  - any of: `string`, `null`
- `isRenewed` (`getContractTrialPeriod.response.200.isRenewed`; boolean, required) — La période d'essai a été renouvelée
- `isOver` (`getContractTrialPeriod.response.200.isOver`; boolean, required) — La période d'essai est terminée : `endDate` est passée (jour calendaire de Paris)
- `renewal` (`getContractTrialPeriod.response.200.renewal`; object, required) — Renouvellement de la période d'essai
  - `isPossible` (`getContractTrialPeriod.response.200.renewal.isPossible`; boolean, required) — La période d'essai peut être renouvelée maintenant
  - `refusalReason` (`getContractTrialPeriod.response.200.renewal.refusalReason`; string | null, required) — Raison pour laquelle le renouvellement est impossible, en français ; null s'il est possible
  - `maxEndDate` (`getContractTrialPeriod.response.200.renewal.maxEndDate`; any of, required) — Fin nominale la plus tardive du renouvellement, et sa valeur par défaut : même durée que la période initiale, comptée à partir du lendemain de la fin actuelle. Null si le renouvellement est impossible.
    - any of: `string`, `null`
  - `projectedEndDate` (`getContractTrialPeriod.response.200.renewal.projectedEndDate`; any of, required) — Fin du renouvellement à `maxEndDate`, prolongée des absences validées déjà connues pendant le renouvellement. Null si le renouvellement est impossible.
    - any of: `string`, `null`

### 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` (`getContractTrialPeriod.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`getContractTrialPeriod.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` (`getContractTrialPeriod.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`getContractTrialPeriod.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Contrat introuvable dans l’entreprise

#### Example

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

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


Source: https://docs.puncto.fr/reference/contracts/get-trial-period/index.md
