---
title: "Lister le suivi des déclarations"
description: "Liste le suivi des déclarations déposées par Puncto pour une `source`, de la plus récente à la plus ancienne.\n\nPour les DSN mensuelles, seul le dernier suivi de chaque mois est listé (une déclaration redéposée après une erreur n’apparaît qu’une fois). `simplifiedStatus` résume l’étape du dépôt et les retours des organismes ; le fichier déclaré se télécharge avec `GET /public/v1/documents/{documentId}/download`."
---

> 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 › Déclarations

`GET /public/v1/declaration-trackings`

Liste le suivi des déclarations déposées par Puncto pour une `source`, de la plus récente à la plus ancienne.

Pour les DSN mensuelles, seul le dernier suivi de chaque mois est listé (une déclaration redéposée après une erreur n’apparaît qu’une fois). `simplifiedStatus` résume l’étape du dépôt et les retours des organismes ; le fichier déclaré se télécharge avec `GET /public/v1/documents/{documentId}/download`.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `source` (`listDeclarationTrackings.query.source`; string, required) — Déclarations à lister.
  - one of `"dsn"`, `"dpae"`, `"fctu"`, `"arret"`
- `page` (`listDeclarationTrackings.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listDeclarationTrackings.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `statuses[]` (`listDeclarationTrackings.query.statuses[]`; array<string>, optional) — Statuts simplifiés à garder. Répétez le paramètre pour en passer plusieurs.
- `months[]` (`listDeclarationTrackings.query.months[]`; array<string>, optional) — Mois de rattachement à garder, au format `YYYY-MM` (voir `period`). Répétez le paramètre pour en passer plusieurs.

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://api.puncto.fr/public/v1/declaration-trackings?source=dsn' \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de suivis de déclarations

#### Example

```json
{
  "data": [
    {
      "declarationTrackingId": "dtra_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "type": "DSN",
      "kind": "STOPPAGE",
      "status": "queued",
      "simplifiedStatus": "in-progress",
      "crmStatus": "ok",
      "idFlux": "string",
      "period": "string",
      "payrollMonthId": "pmon_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "endOfContractId": "eoco_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "absenceId": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "documentId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "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` (`listDeclarationTrackings.response.200.data`; array<object>, required)
  - `declarationTrackingId` (`listDeclarationTrackings.response.200.data.declarationTrackingId`; any of, required) — Identifiant Puncto du suivi
    - any of: `string`, `string`
  - `type` (`listDeclarationTrackings.response.200.data.type`; string, required) — Déclaration suivie : `DSN` (mensuelle), `DPAE`, `FCTU` (fin de contrat) ou `ARRET` (signalement)
    - one of `"DSN"`, `"DPAE"`, `"FCTU"`, `"ARRET"`
  - `kind` (`listDeclarationTrackings.response.200.data.kind`; any of, required) — Signalement (`ARRET`) : arrêt de travail ou reprise anticipée, null pour les autres déclarations
    - any of: `ArretDeclarationKind`, `null`
  - `status` (`listDeclarationTrackings.response.200.data.status`; any of, required) — Étape du dépôt de la déclaration
    - any of: `DsnTrackingStatus`, `DpaeTrackingStatus`
  - `simplifiedStatus` (`listDeclarationTrackings.response.200.data.simplifiedStatus`; string, required) — Statut simplifié : en cours, transmise, confirmée ou en erreur
    - one of `"in-progress"`, `"sent"`, `"confirmed"`, `"error"`
  - `crmStatus` (`listDeclarationTrackings.response.200.data.crmStatus`; string | null, required) — Synthèse des comptes rendus des organismes (CRM) : `ok`, `error` (anomalie à traiter), `handled` (anomalies traitées), null sans retour et pour une DPAE
    - one of `"ok"`, `"error"`, `"handled"`, `null`
  - `idFlux` (`listDeclarationTrackings.response.200.data.idFlux`; string | null, required) — Identifiant du dépôt attribué par net-entreprises, null avant le dépôt
  - `period` (`listDeclarationTrackings.response.200.data.period`; string | null, required) — Mois de rattachement (`YYYY-MM`) : mois de paie d'une DSN mensuelle, mois d'embauche d'une DPAE, mois de fin de contrat d'une FCTU, mois du dernier jour travaillé d'un signalement. C'est le mois que filtre `months[]`
  - `payrollMonthId` (`listDeclarationTrackings.response.200.data.payrollMonthId`; any of, required) — DSN mensuelle : mois de paie déclaré
    - any of: `string`, `null`
  - `collaboratorId` (`listDeclarationTrackings.response.200.data.collaboratorId`; any of, required) — Collaborateur concerné, null pour une DSN mensuelle
    - any of: `string`, `null`
  - `contractId` (`listDeclarationTrackings.response.200.data.contractId`; any of, required) — Contrat concerné (DPAE, FCTU, signalement), null pour une DSN mensuelle
    - any of: `string`, `null`
  - `endOfContractId` (`listDeclarationTrackings.response.200.data.endOfContractId`; any of, required) — FCTU : clôture du contrat déclarée
    - any of: `string`, `null`
  - `absenceId` (`listDeclarationTrackings.response.200.data.absenceId`; any of, required) — Signalement : absence portant l'arrêt de travail
    - any of: `string`, `null`
  - `documentId` (`listDeclarationTrackings.response.200.data.documentId`; any of, required) — Fichier de la déclaration, téléchargeable avec `GET /public/v1/documents/{documentId}/download`, null tant qu'il n'est pas généré
    - any of: `string`, `null`
  - `createdAt` (`listDeclarationTrackings.response.200.data.createdAt`; string, required) — Date de création du suivi
    - format `date-time`
  - `updatedAt` (`listDeclarationTrackings.response.200.data.updatedAt`; string, required) — Date de dernière mise à jour du suivi
    - format `date-time`
- `meta` (`listDeclarationTrackings.response.200.meta`; object, required)
  - `total` (`listDeclarationTrackings.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listDeclarationTrackings.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listDeclarationTrackings.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listDeclarationTrackings.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listDeclarationTrackings.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listDeclarationTrackings.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` (`listDeclarationTrackings.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listDeclarationTrackings.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` (`listDeclarationTrackings.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listDeclarationTrackings.response.403.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` (`listDeclarationTrackings.response.422.errors`; array<object>, required)
  - `message` (`listDeclarationTrackings.response.422.errors.message`; string, required)
  - `rule` (`listDeclarationTrackings.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`listDeclarationTrackings.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/declaration-trackings/list/index.md
