---
title: "Consulter un contrat"
description: "Renvoie le contrat `{contractId}`, quels que soient son statut et ses dates.\n\nAvec `matchingBy`, `{contractId}` désigne un collaborateur : Puncto renvoie son contrat en vigueur à `matchingDate`, au format `ApiContractFull` (données personnelles et manager inclus ; `managerImageKey` toujours `null`). C’est ainsi qu’on passe de votre identifiant à celui de Puncto : seul l’identifiant Puncto du contrat sert ensuite à le modifier, le supprimer ou agir sur sa période d’essai."
---

> 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}`

Renvoie le contrat `{contractId}`, quels que soient son statut et ses dates.

Avec `matchingBy`, `{contractId}` désigne un collaborateur : Puncto renvoie son contrat en vigueur à `matchingDate`, au format `ApiContractFull` (données personnelles et manager inclus ; `managerImageKey` toujours `null`). C’est ainsi qu’on passe de votre identifiant à celui de Puncto : seul l’identifiant Puncto du contrat sert ensuite à le modifier, le supprimer ou agir sur sa période d’essai.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `contractId` (`getContract.path.contractId`; string, required) — Identifiant Puncto du contrat ; avec `matchingBy`, l’identifiant qu’il précise.
  - example `"cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Query parameters

- `matchingBy` (`getContract.query.matchingBy`; string, optional) — Facultatif : nature de la valeur du chemin, pour chercher le contrat en vigueur d’un collaborateur. Ne pas combiner avec `referenceDate`. - `BY_COLLABORATOR_FOREIGN_ERP_ID` : `foreignErpId` du collaborateur - `BY_PUNCTO_COLLABORATOR_ID` : identifiant Puncto du collaborateur - `BY_PUNCTO_CONTRACT_ID` : déprécié : identifiant Puncto d’un contrat, dont le collaborateur est retenu. Renvoie son contrat en vigueur, qui peut en être un autre ; pour ce contrat-là, n’envoyez pas `matchingBy`
  - one of `"BY_COLLABORATOR_FOREIGN_ERP_ID"`, `"BY_PUNCTO_COLLABORATOR_ID"`, `"BY_PUNCTO_CONTRACT_ID"`
- `matchingDate` (`getContract.query.matchingDate`; string, optional) — Avec `matchingBy` seulement : date à laquelle chercher le contrat en vigueur. Par défaut, aujourd’hui.
  - format `date`; example `"2026-10-01"`
- `referenceDate` (`getContract.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/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Contrat : `PublicApiContract` sans `matchingBy`, `ApiContractFull` avec

#### Example

```json
{
  "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": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "TUESDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "WEDNESDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "THURSDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "FRIDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "SATURDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        },
        "SUNDAY": {
          "morning": {
            "start": "string",
            "end": "string"
          },
          "afternoon": {
            "start": "string",
            "end": "string"
          }
        }
      }
    },
    "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": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "TUESDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "WEDNESDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "THURSDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "FRIDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "SATURDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          },
          "SUNDAY": {
            "morning": {
              "start": "string",
              "end": "string"
            },
            "afternoon": {
              "start": "string",
              "end": "string"
            }
          }
        }
      },
      "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"
}
```

One of:

- `PublicApiContract`
- `ApiContractFull`

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

### 404

Contrat introuvable ; avec `matchingBy`, collaborateur introuvable ou aucun contrat à cette date

#### Example

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

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


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