---
title: "Consulter une absence"
description: "Renvoie une absence, au même format que la liste des absences.\n\nPour une prolongation d’arrêt de travail, `workStoppage` décrit l’arrêt initial (dernier jour travaillé, subrogation, dates d’accident ou de constatation), avec l’avis de prolongation pour justificatif.\n\nLes justificatifs (`familyProofFile`, `workStoppage.proofFile`) se téléchargent avec `GET /public/v1/documents/{documentId}/download`, leur `id` servant de `documentId`."
---

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

`GET /public/v1/absences/{absenceId}`

Renvoie une absence, au même format que la liste des absences.

Pour une prolongation d’arrêt de travail, `workStoppage` décrit l’arrêt initial (dernier jour travaillé, subrogation, dates d’accident ou de constatation), avec l’avis de prolongation pour justificatif.

Les justificatifs (`familyProofFile`, `workStoppage.proofFile`) se téléchargent avec `GET /public/v1/documents/{documentId}/download`, leur `id` servant de `documentId`.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `absenceId` (`getAbsence.path.absenceId`; string, required) — Identifiant Puncto de l’absence.
  - example `"abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Absence

#### Example

```json
{
  "startDate": "2019-08-24",
  "endDate": "2019-08-24",
  "duration": 0,
  "durationExplanation": "string",
  "familyEventType": "deces_enfant_moins_25_non_parent_oui",
  "parentalLeaveType": "BIRTH_ADDITIONAL_LEAVE",
  "childArrivalDate": "2019-08-24",
  "pregnancyExamBeneficiary": "PREGNANT_EMPLOYEE",
  "maternityLeaveSituation": "FIRST_OR_SECOND",
  "actualBirthDate": "2019-08-24",
  "hasPathologicalPrenatalState": true,
  "adoptionLeaveSituation": "ONE_CHILD",
  "childArrivalType": "BIRTH",
  "familyProofFile": {
    "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
    "displayFileName": "string",
    "fileType": "PAYSLIP",
    "file": {
      "key": "string",
      "mimeType": "image/jpeg"
    },
    "collaborator": {
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string",
      "imageKey": "string"
    },
    "generatedByUserAccount": {
      "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string"
    },
    "createdAt": "2019-08-24T14:15:22Z"
  },
  "workStoppage": {
    "lastWorkedDay": "2019-08-24",
    "accidentDate": "2019-08-24",
    "diseaseObservationDate": "2019-08-24",
    "proofFile": {
      "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "displayFileName": "string",
      "fileType": "PAYSLIP",
      "file": {
        "key": "string",
        "mimeType": "image/jpeg"
      },
      "collaborator": {
        "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string",
        "imageKey": "string"
      },
      "generatedByUserAccount": {
        "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string"
      },
      "createdAt": "2019-08-24T14:15:22Z"
    },
    "withSubrogation": true,
    "isProlongation": true
  },
  "workStoppageDsn": {
    "declaredForecastEndDate": "2019-08-24",
    "isDsnDeclared": true,
    "resumption": {
      "id": "wsre_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "resumptionDate": "2019-08-24",
      "resumptionMotive": "01",
      "signalementRequired": true,
      "trackingStatus": "queued"
    },
    "pendingDeclaration": {
      "kind": "scheduled",
      "scheduledAt": "2019-08-24T14:15:22Z"
    }
  },
  "foreignErpId": "string",
  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "createdAt": "2019-08-24T14:15:22Z",
  "isLocked": true,
  "lockState": {
    "state": "OPEN"
  },
  "lateInputRegularisation": {
    "status": "PENDING",
    "carrierYear": 0,
    "carrierMonth": 0
  },
  "isDsnLocked": true,
  "id": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "type": "JNT",
  "status": "pending",
  "onlyHalfDayAtStart": true,
  "onlyHalfDayAtEnd": true,
  "collaboratorForeignErpId": "string",
  "isProlongation": true
}
```

- `startDate` (`getAbsence.response.200.startDate`; string, required)
  - format `date`
- `endDate` (`getAbsence.response.200.endDate`; string, required)
  - format `date`
- `duration` (`getAbsence.response.200.duration`; number, required)
- `durationExplanation` (`getAbsence.response.200.durationExplanation`; string, required)
- `parentalLeaveType` (`getAbsence.response.200.parentalLeaveType`; any of, required) — Type de congé parental (congé de maternité, de paternité, d'adoption, supplémentaire de naissance), null pour toute autre absence.
  - any of: `ParentalLeaveType`, `null`
- `foreignErpId` (`getAbsence.response.200.foreignErpId`; string | null, required)
- `contractId` (`getAbsence.response.200.contractId`; string, required) — Identifiant Puncto
- `collaboratorId` (`getAbsence.response.200.collaboratorId`; string, required) — Identifiant Puncto
- `createdAt` (`getAbsence.response.200.createdAt`; string, required) — Date à laquelle la demande d'absence a été posée.
  - format `date-time`
- `isLocked` (`getAbsence.response.200.isLocked`; boolean, required) — True when the absence can no longer be modified: one of its payroll months is closed and no open payslip can carry the regularisation (`lockState.state === 'BLOCKED'`).
- `lockState` (`getAbsence.response.200.lockState`; any of, required) — État de saisie sur les mois couverts par l'absence (saisie tardive possible)
  - any of: `object`, `object`, `object`
- `isDsnLocked` (`getAbsence.response.200.isDsnLocked`; boolean, required) — True when the DSN of the underlying work stoppage is being transmitted or already deposited. The absence can then no longer be edited, cancelled or deleted.
- `id` (`getAbsence.response.200.id`; string, required) — Identifiant Puncto
- `type` (`getAbsence.response.200.type`; string, required)
  - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"PARENTAL"`, `"REST"`, `"SICK"`, `"SICK_AT"`, `"SICK_MP"`, `"SICK_ATJ"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
- `status` (`getAbsence.response.200.status`; string, required)
  - one of `"pending"`, `"validated"`, `"rejected"`, `"canceled"`, `"technical-cancel"`
- `onlyHalfDayAtStart` (`getAbsence.response.200.onlyHalfDayAtStart`; boolean, required)
- `onlyHalfDayAtEnd` (`getAbsence.response.200.onlyHalfDayAtEnd`; boolean, required)
- `collaboratorForeignErpId` (`getAbsence.response.200.collaboratorForeignErpId`; string | null, required)
- `isProlongation` (`getAbsence.response.200.isProlongation`; boolean, required) — Prolongation d'un arrêt de travail : `workStoppage` est alors l'arrêt initial, avec l'avis de prolongation pour justificatif.
- `familyEventType` (`getAbsence.response.200.familyEventType`; any of, optional)
  - any of: `FamilyEventType`, `null`
- `childArrivalDate` (`getAbsence.response.200.childArrivalDate`; any of, optional)
  - any of: `string`, `null`
- `pregnancyExamBeneficiary` (`getAbsence.response.200.pregnancyExamBeneficiary`; any of, optional) — Examens de grossesse : la salariée enceinte elle-même, ou son conjoint.
  - any of: `PregnancyExamBeneficiary`, `null`
- `maternityLeaveSituation` (`getAbsence.response.200.maternityLeaveSituation`; any of, optional) — Congé de maternité : rang de l'enfant ou naissance multiple, qui fixe la durée légale.
  - any of: `MaternityLeaveSituation`, `null`
- `actualBirthDate` (`getAbsence.response.200.actualBirthDate`; any of, optional) — Congé de maternité : date réelle de l'accouchement, une fois connue.
  - any of: `string`, `null`
- `hasPathologicalPrenatalState` (`getAbsence.response.200.hasPathologicalPrenatalState`; boolean, optional) — Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance).
- `adoptionLeaveSituation` (`getAbsence.response.200.adoptionLeaveSituation`; any of, optional) — Congé d'adoption : nombre d'enfants à charge ou adoption multiple, qui fixe la durée légale.
  - any of: `AdoptionLeaveSituation`, `null`
- `childArrivalType` (`getAbsence.response.200.childArrivalType`; any of, optional) — Congé de naissance : naissance ou adoption de l'enfant, purement informatif.
  - any of: `ChildArrivalType`, `null`
- `familyProofFile` (`getAbsence.response.200.familyProofFile`; any of, optional)
  - any of: `ApiCompanyFile`, `null`
- `workStoppage` (`getAbsence.response.200.workStoppage`; object, optional)
  - `lastWorkedDay` (`getAbsence.response.200.workStoppage.lastWorkedDay`; string, required)
    - format `date`
  - `accidentDate` (`getAbsence.response.200.workStoppage.accidentDate`; any of, required)
    - any of: `string`, `null`
  - `diseaseObservationDate` (`getAbsence.response.200.workStoppage.diseaseObservationDate`; any of, required)
    - any of: `string`, `null`
  - `proofFile` (`getAbsence.response.200.workStoppage.proofFile`; any of, required)
    - any of: `ApiCompanyFile`, `null`
  - `withSubrogation` (`getAbsence.response.200.workStoppage.withSubrogation`; boolean, required)
  - `isProlongation` (`getAbsence.response.200.workStoppage.isProlongation`; boolean, required) — Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial.
- `workStoppageDsn` (`getAbsence.response.200.workStoppageDsn`; object, optional) — État déclaratif de l'arrêt de travail porté par cette absence. Renseigné par les listes internes seulement : le calculer suppose de lire les suivis DSN et la reprise, ce que l'API publique ne fait pas. Son absence ne veut donc pas dire « rien à déclarer », mais « information non chargée ici ».
  - `declaredForecastEndDate` (`getAbsence.response.200.workStoppageDsn.declaredForecastEndDate`; any of, required) — Date de fin prévisionnelle (S21.G00.60.003) telle que le signalement d'arrêt l'a déclarée. Null tant qu'aucun signalement n'a abouti : c'est elle qui dit si une reprise est anticipée.
    - any of: `string`, `null`
  - `isDsnDeclared` (`getAbsence.response.200.workStoppageDsn.isDsnDeclared`; boolean, required) — Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu).
  - `resumption` (`getAbsence.response.200.workStoppageDsn.resumption`; any of, required) — Reprise anticipée déclarée sur cet arrêt, le cas échéant.
    - any of: `ApiWorkStoppageResumption`, `null`
  - `pendingDeclaration` (`getAbsence.response.200.workStoppageDsn.pendingDeclaration`; any of, required) — Signalement d'arrêt que l'automatisation doit encore déposer : aucune reprise ne peut être saisie avant lui. Null quand l'arrêt est déclaré, ou que l'automatisation ne le déclarera pas.
    - any of: `ApiPendingWorkStoppageDeclaration`, `null`
- `lateInputRegularisation` (`getAbsence.response.200.lateInputRegularisation`; any of, optional) — Dernière saisie tardive faite sur cette entité, `null` s'il n'y en a pas. Renseigné par les listes internes seulement : son absence veut dire « information non chargée ici ».
  - any of: `ApiLateInputRegularisation`, `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` (`getAbsence.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`getAbsence.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` (`getAbsence.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`getAbsence.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Absence introuvable

#### Example

```json
{
  "error": "Absence non trouvée"
}
```

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


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