---
title: "Valider la période d’essai"
description: "Valide la période d’essai par anticipation : elle prend fin à `validationDate`, le contrat devient définitif, et la période n’est plus prolongée ni renouvelable.\n\nLa date peut être passée, mais doit tomber entre le début du contrat (du renouvellement, pour une période renouvelée) et la fin prévue de la période. Refusé une fois la période terminée, dernier jour compris, ou déjà validé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

`POST /public/v1/contracts/{contractId}/trial-period/actions/validate`

Valide la période d’essai par anticipation : elle prend fin à `validationDate`, le contrat devient définitif, et la période n’est plus prolongée ni renouvelable.

La date peut être passée, mais doit tomber entre le début du contrat (du renouvellement, pour une période renouvelée) et la fin prévue de la période. Refusé une fois la période terminée, dernier jour compris, ou déjà validée.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

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

## Request body

_Optional._

- `validationDate` (`validateContractTrialPeriod.validationDate`; string, optional) — Date de la validation. Par défaut, aujourd’hui (jour calendaire de Paris).
  - format `date`; example `"2026-11-16"`

## Example request

```json
{
  "validationDate": "2026-11-16"
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.puncto.fr/public/v1/contracts/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY/trial-period/actions/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validationDate": "2026-11-16"
}
'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/contracts/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY/trial-period/actions/validate';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({validationDate: '2026-11-16'})
};

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/actions/validate"

payload = { "validationDate": "2026-11-16" }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

Période d’essai du contrat après la validation

#### 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` (`validateContractTrialPeriod.response.200.contractId`; string, required) — Identifiant Puncto du contrat
- `collaboratorId` (`validateContractTrialPeriod.response.200.collaboratorId`; string, required) — Identifiant Puncto du collaborateur
- `collaboratorForeignErpId` (`validateContractTrialPeriod.response.200.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
- `workerType` (`validateContractTrialPeriod.response.200.workerType`; any of, required) — Type de contrat, null pour un contrat en cours de création
  - any of: `WorkerType`, `null`
- `contractStartDate` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.response.200.trialPeriods.id`; string, required) — Identifiant Puncto de la période d'essai
  - `type` (`validateContractTrialPeriod.response.200.trialPeriods.type`; string, required) — Période initiale ou renouvellement
    - one of `"initial"`, `"renewal"`
  - `initialEndDate` (`validateContractTrialPeriod.response.200.trialPeriods.initialEndDate`; string, required) — Fin nominale : celle prévue au contrat, ou choisie au renouvellement
    - format `date`
  - `recalculatedEndDate` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.response.200.trialPeriods.recalculationDate`; any of, required) — Date du dernier recalcul de la fin
    - any of: `string`, `null`
  - `validationDate` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.response.200.trialPeriods.createdAt`; string, required) — Date d'enregistrement de la période dans Puncto
    - format `date-time`
- `endDate` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.response.200.isRenewed`; boolean, required) — La période d'essai a été renouvelée
- `isOver` (`validateContractTrialPeriod.response.200.isOver`; boolean, required) — La période d'essai est terminée : `endDate` est passée (jour calendaire de Paris)
- `renewal` (`validateContractTrialPeriod.response.200.renewal`; object, required) — Renouvellement de la période d'essai
  - `isPossible` (`validateContractTrialPeriod.response.200.renewal.isPossible`; boolean, required) — La période d'essai peut être renouvelée maintenant
  - `refusalReason` (`validateContractTrialPeriod.response.200.renewal.refusalReason`; string | null, required) — Raison pour laquelle le renouvellement est impossible, en français ; null s'il est possible
  - `maxEndDate` (`validateContractTrialPeriod.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` (`validateContractTrialPeriod.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`

### 400

Validation refusée : période terminée ou déjà validée, contrat clôturé, date hors de la période…

#### Example

```json
{
  "error": "La période d’essai a déjà été validée"
}
```

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

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

### 404

Contrat introuvable dans l’entreprise

#### Example

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

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


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