---
title: "Lister les relevés forfait jours"
description: "Liste les relevés mensuels des collaborateurs au forfait jours, du plus récent au plus ancien : jours travaillés et d’absence par demi-journée, repos et charge de travail déclarés."
---

> 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 › Temps et congés

`GET /public/v1/forfait-jour-declarations`

Liste les relevés mensuels des collaborateurs au forfait jours, du plus récent au plus ancien : jours travaillés et d’absence par demi-journée, repos et charge de travail déclarés.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listForfaitJourDeclarations.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listForfaitJourDeclarations.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `year` (`listForfaitJourDeclarations.query.year`; integer, optional) — Année du relevé.
  - min 2000; max 2100; example `2026`
- `month` (`listForfaitJourDeclarations.query.month`; integer, optional) — Mois du relevé, de 1 (janvier) à 12.
  - min 1; max 12; example `9`
- `status[]` (`listForfaitJourDeclarations.query.status[]`; array<string>, optional) — Statuts à garder. Répétez le paramètre pour en passer plusieurs.
- `contractId` (`listForfaitJourDeclarations.query.contractId`; string, optional) — Identifiant Puncto du contrat.
  - example `"cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorId` (`listForfaitJourDeclarations.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listForfaitJourDeclarations.query.collaboratorForeignErpId`; string, optional) — Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.
  - example `"salarie-123"`

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de relevés forfait jours

#### Example

```json
{
  "data": [
    {
      "forfaitJourDeclarationId": "fjde_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorForeignErpId": "string",
      "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "year": 0,
      "month": 0,
      "status": "PENDING",
      "isCalendarAccurate": true,
      "calendarComment": "string",
      "isRestRespected": true,
      "restComment": "string",
      "workloadStatus": "NORMAL",
      "workloadComment": "string",
      "workedDaysCount": 0,
      "sickDaysCount": 0,
      "unpaidDaysCount": 0,
      "familyDaysCount": 0,
      "parentalLeaveDaysCount": 0,
      "days": [
        {
          "date": "2019-08-24",
          "morningDayType": "JT",
          "afternoonDayType": "JT"
        }
      ],
      "submittedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listForfaitJourDeclarations.response.200.data`; array<object>, required)
  - `forfaitJourDeclarationId` (`listForfaitJourDeclarations.response.200.data.forfaitJourDeclarationId`; string, required) — Identifiant Puncto du relevé
  - `collaboratorId` (`listForfaitJourDeclarations.response.200.data.collaboratorId`; string, required) — Identifiant Puncto du collaborateur
  - `collaboratorForeignErpId` (`listForfaitJourDeclarations.response.200.data.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
  - `contractId` (`listForfaitJourDeclarations.response.200.data.contractId`; string, required) — Identifiant Puncto du contrat
  - `year` (`listForfaitJourDeclarations.response.200.data.year`; number, required) — Année du relevé
  - `month` (`listForfaitJourDeclarations.response.200.data.month`; number, required) — Mois du relevé (1-12)
  - `status` (`listForfaitJourDeclarations.response.200.data.status`; string, required) — En attente, conforme ou anomalie
    - one of `"PENDING"`, `"CONFORM"`, `"ANOMALY"`
  - `isCalendarAccurate` (`listForfaitJourDeclarations.response.200.data.isCalendarAccurate`; boolean, required) — Le collaborateur confirme que le calendrier du mois est exact
  - `calendarComment` (`listForfaitJourDeclarations.response.200.data.calendarComment`; string | null, required) — Commentaire du collaborateur sur le calendrier
  - `isRestRespected` (`listForfaitJourDeclarations.response.200.data.isRestRespected`; boolean, required) — Le collaborateur confirme avoir respecté les temps de repos
  - `restComment` (`listForfaitJourDeclarations.response.200.data.restComment`; string | null, required) — Commentaire du collaborateur sur les temps de repos
  - `workloadStatus` (`listForfaitJourDeclarations.response.200.data.workloadStatus`; any of, required) — Charge de travail ressentie, null avant la soumission
    - any of: `ForfaitJourDeclarationWorkloadStatus`, `null`
  - `workloadComment` (`listForfaitJourDeclarations.response.200.data.workloadComment`; string | null, required) — Commentaire du collaborateur sur sa charge de travail
  - `workedDaysCount` (`listForfaitJourDeclarations.response.200.data.workedDaysCount`; number, required) — Jours travaillés du mois
  - `sickDaysCount` (`listForfaitJourDeclarations.response.200.data.sickDaysCount`; number, required) — Jours d'arrêt maladie du mois
  - `unpaidDaysCount` (`listForfaitJourDeclarations.response.200.data.unpaidDaysCount`; number, required) — Jours de congé sans solde du mois
  - `familyDaysCount` (`listForfaitJourDeclarations.response.200.data.familyDaysCount`; number, required) — Jours de congés familiaux du mois
  - `parentalLeaveDaysCount` (`listForfaitJourDeclarations.response.200.data.parentalLeaveDaysCount`; number, required) — Jours de congé parental du mois
  - `days` (`listForfaitJourDeclarations.response.200.data.days`; array<object>, required) — Jours du mois, par demi-journée
    - `date` (`listForfaitJourDeclarations.response.200.data.days.date`; string, required) — Jour
      - format `date`
    - `morningDayType` (`listForfaitJourDeclarations.response.200.data.days.morningDayType`; string, required) — Nature du matin
      - one of `"JT"`, `"JF"`, `"CP"`, `"JNT"`, `"CSS"`, `"MO"`, `"AT"`, `"MP"`, `"ATJ"`, `"FAM"`, `"AN"`, `"REP"`, `"HC"`
    - `afternoonDayType` (`listForfaitJourDeclarations.response.200.data.days.afternoonDayType`; string, required) — Nature de l'après-midi
      - one of `"JT"`, `"JF"`, `"CP"`, `"JNT"`, `"CSS"`, `"MO"`, `"AT"`, `"MP"`, `"ATJ"`, `"FAM"`, `"AN"`, `"REP"`, `"HC"`
  - `submittedAt` (`listForfaitJourDeclarations.response.200.data.submittedAt`; any of, required) — Date de soumission par le collaborateur, null tant qu'il ne l'a pas soumis
    - any of: `string`, `null`
  - `createdAt` (`listForfaitJourDeclarations.response.200.data.createdAt`; string, required) — Date de création du relevé
    - format `date-time`
  - `updatedAt` (`listForfaitJourDeclarations.response.200.data.updatedAt`; string, required) — Date de dernière modification du relevé
    - format `date-time`
- `meta` (`listForfaitJourDeclarations.response.200.meta`; object, required)
  - `total` (`listForfaitJourDeclarations.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listForfaitJourDeclarations.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listForfaitJourDeclarations.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listForfaitJourDeclarations.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listForfaitJourDeclarations.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listForfaitJourDeclarations.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` (`listForfaitJourDeclarations.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listForfaitJourDeclarations.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` (`listForfaitJourDeclarations.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listForfaitJourDeclarations.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Collaborateur du filtre introuvable

#### Example

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

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


Source: https://docs.puncto.fr/reference/forfait-jour-declarations/list/index.md
