---
title: "Lister les absences"
description: "Liste paginée des absences de l’entreprise, par date de début décroissante.\n\nUne prolongation d’arrêt de travail a `isProlongation` à `true` : son `workStoppage` est l’arrêt initial, avec l’avis de prolongation pour justificatif."
---

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

Liste paginée des absences de l’entreprise, par date de début décroissante.

Une prolongation d’arrêt de travail a `isProlongation` à `true` : son `workStoppage` est l’arrêt initial, avec l’avis de prolongation pour justificatif.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listAbsences.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listAbsences.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `type[]` (`listAbsences.query.type[]`; array<string>, optional) — Types d’absence à garder. Répétez le paramètre pour en passer plusieurs.
- `status[]` (`listAbsences.query.status[]`; array<string>, optional) — Statuts à garder. Répétez le paramètre pour en passer plusieurs.
- `contractId` (`listAbsences.query.contractId`; string, optional) — Identifiant Puncto du contrat.
- `collaboratorId` (`listAbsences.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listAbsences.query.collaboratorForeignErpId`; string, optional) — Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.
  - example `"salarie-123"`
- `minCreationDate` (`listAbsences.query.minCreationDate`; string, optional) — Absences créées à partir de cette date (ISO 8601).
  - format `date-time`
- `maxCreationDate` (`listAbsences.query.maxCreationDate`; string, optional) — Absences créées jusqu’à cette date (ISO 8601).
  - format `date-time`

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page d’absences

#### Example

```json
{
  "data": [
    {
      "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
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listAbsences.response.200.data`; array<object>, required)
  - `startDate` (`listAbsences.response.200.data.startDate`; string, required)
    - format `date`
  - `endDate` (`listAbsences.response.200.data.endDate`; string, required)
    - format `date`
  - `duration` (`listAbsences.response.200.data.duration`; number, required)
  - `durationExplanation` (`listAbsences.response.200.data.durationExplanation`; string, required)
  - `parentalLeaveType` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.foreignErpId`; string | null, required)
  - `contractId` (`listAbsences.response.200.data.contractId`; string, required) — Identifiant Puncto
  - `collaboratorId` (`listAbsences.response.200.data.collaboratorId`; string, required) — Identifiant Puncto
  - `createdAt` (`listAbsences.response.200.data.createdAt`; string, required) — Date à laquelle la demande d'absence a été posée.
    - format `date-time`
  - `isLocked` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.lockState`; any of, required) — État de saisie sur les mois couverts par l'absence (saisie tardive possible)
    - any of: `object`, `object`, `object`
  - `isDsnLocked` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.id`; string, required) — Identifiant Puncto
  - `type` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.status`; string, required)
    - one of `"pending"`, `"validated"`, `"rejected"`, `"canceled"`, `"technical-cancel"`
  - `onlyHalfDayAtStart` (`listAbsences.response.200.data.onlyHalfDayAtStart`; boolean, required)
  - `onlyHalfDayAtEnd` (`listAbsences.response.200.data.onlyHalfDayAtEnd`; boolean, required)
  - `collaboratorForeignErpId` (`listAbsences.response.200.data.collaboratorForeignErpId`; string | null, required)
  - `isProlongation` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.familyEventType`; any of, optional)
    - any of: `FamilyEventType`, `null`
  - `childArrivalDate` (`listAbsences.response.200.data.childArrivalDate`; any of, optional)
    - any of: `string`, `null`
  - `pregnancyExamBeneficiary` (`listAbsences.response.200.data.pregnancyExamBeneficiary`; any of, optional) — Examens de grossesse : la salariée enceinte elle-même, ou son conjoint.
    - any of: `PregnancyExamBeneficiary`, `null`
  - `maternityLeaveSituation` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.actualBirthDate`; any of, optional) — Congé de maternité : date réelle de l'accouchement, une fois connue.
    - any of: `string`, `null`
  - `hasPathologicalPrenatalState` (`listAbsences.response.200.data.hasPathologicalPrenatalState`; boolean, optional) — Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance).
  - `adoptionLeaveSituation` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.childArrivalType`; any of, optional) — Congé de naissance : naissance ou adoption de l'enfant, purement informatif.
    - any of: `ChildArrivalType`, `null`
  - `familyProofFile` (`listAbsences.response.200.data.familyProofFile`; any of, optional)
    - any of: `ApiCompanyFile`, `null`
  - `workStoppage` (`listAbsences.response.200.data.workStoppage`; object, optional)
    - `lastWorkedDay` (`listAbsences.response.200.data.workStoppage.lastWorkedDay`; string, required)
      - format `date`
    - `accidentDate` (`listAbsences.response.200.data.workStoppage.accidentDate`; any of, required)
      - any of: `string`, `null`
    - `diseaseObservationDate` (`listAbsences.response.200.data.workStoppage.diseaseObservationDate`; any of, required)
      - any of: `string`, `null`
    - `proofFile` (`listAbsences.response.200.data.workStoppage.proofFile`; any of, required)
      - any of: `ApiCompanyFile`, `null`
    - `withSubrogation` (`listAbsences.response.200.data.workStoppage.withSubrogation`; boolean, required)
    - `isProlongation` (`listAbsences.response.200.data.workStoppage.isProlongation`; boolean, required) — Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial.
  - `workStoppageDsn` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.workStoppageDsn.isDsnDeclared`; boolean, required) — Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu).
    - `resumption` (`listAbsences.response.200.data.workStoppageDsn.resumption`; any of, required) — Reprise anticipée déclarée sur cet arrêt, le cas échéant.
      - any of: `ApiWorkStoppageResumption`, `null`
    - `pendingDeclaration` (`listAbsences.response.200.data.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` (`listAbsences.response.200.data.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`
- `meta` (`listAbsences.response.200.meta`; object, required)
  - `total` (`listAbsences.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listAbsences.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listAbsences.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listAbsences.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listAbsences.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listAbsences.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` (`listAbsences.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listAbsences.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` (`listAbsences.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listAbsences.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Collaborateur du filtre introuvable

#### Example

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

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


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