---
title: "Lister les documents"
description: "Liste paginée des documents de l’entreprise, du plus récent au plus ancien : documents envoyés par l’API ou dans Puncto (contrats signés, conventions de stage…) et documents générés par Puncto (bulletins, DPAE, DSN, documents de fin de contrat, documents comptables…). Téléchargez un fichier avec `GET /public/v1/documents/{documentId}/download`.\n\nLes fichiers techniques (retours DPAE, CRM), les factures Puncto et les archives d’export ne sont pas exposés. Un filtre collaborateur exclut les documents sans collaborateur."
---

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

`GET /public/v1/documents`

Liste paginée des documents de l’entreprise, du plus récent au plus ancien : documents envoyés par l’API ou dans Puncto (contrats signés, conventions de stage…) et documents générés par Puncto (bulletins, DPAE, DSN, documents de fin de contrat, documents comptables…). Téléchargez un fichier avec `GET /public/v1/documents/{documentId}/download`.

Les fichiers techniques (retours DPAE, CRM), les factures Puncto et les archives d’export ne sont pas exposés. Un filtre collaborateur exclut les documents sans collaborateur.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

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

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de documents

#### Example

```json
{
  "data": [
    {
      "documentId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "foreignErpId": "string",
      "displayFileName": "string",
      "fileName": "string",
      "fileType": "PAYSLIP",
      "mimeType": "image/jpeg",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorForeignErpId": "string",
      "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` (`listDocuments.response.200.data`; array<object>, required)
  - `documentId` (`listDocuments.response.200.data.documentId`; string, required) — Identifiant Puncto du document
  - `foreignErpId` (`listDocuments.response.200.data.foreignErpId`; string | null, required) — Identifiant du document dans votre système, renseigné à l'envoi par l'API ; null sinon
  - `displayFileName` (`listDocuments.response.200.data.displayFileName`; string, required) — Nom du document affiché dans Puncto
  - `fileName` (`listDocuments.response.200.data.fileName`; string, required) — Nom du fichier téléchargé, extension comprise : le nom du document, suivi de l'extension du fichier s'il ne se termine pas déjà par une extension
  - `fileType` (`listDocuments.response.200.data.fileType`; string, required) — Type de document
    - one of `"PAYSLIP"`, `"PAYSLIP_ARCHIVED"`, `"DSN_MONTHLY"`, `"DSN_WORK_STOPPAGE"`, `"DSN_WORK_STOPPAGE_RESUMPTION"`, `"DSN_FCTU"`, `"DSN_SADV"`, `"CRM"`, `"EXPENSE_BILL"`, `"MEAL_VOUCHER_EXPORT"`, `"SEPA_PAYROLL"`, `"SEPA_SDTC"`, `"ABSENCE_PROOF"`, `"DPAE"`, `"DPAE_RETURN"`, `"ACCOUNTING_PAYROLL_OD"`, `"ACCOUNTING_PAYROLL_DSN_RECAP"`, `"ACCOUNTING_CONTRIBUTIONS_DETAIL"`, `"ACCOUNTING_CONTRIBUTIONS_RECAP"`, `"ACCOUNTING_PAYBOOK"`, `"ACCOUNTING_PAYROLL_LOG"`, `"ACCOUNTING_REST_RECAP"`, `"IDENTITY"`, `"VITALE"`, `"RIB"`, `"CONTRACT"`, `"INTERNSHIP_AGREEMENT"`, `"INTERNSHIP_CERTIFICATE"`, `"INTERNSHIP_CERTIFICATE_SIGNED"`, `"WORK_CERTIFICATE"`, `"WORK_CERTIFICATE_SIGNED"`, `"FINAL_SETTLEMENT_RECEIPT"`, `"FINAL_SETTLEMENT_RECEIPT_SIGNED"`, `"PROFIT_SHARING_STATEMENT"`, `"ON_CALL_STATEMENT"`, `"PROFIT_SHARING_AGREEMENT_RECEIPT"`, `"BILLING_INVOICE"`, `"COMPANY_SETUP_CHECKLIST"`, `"FCTU_AER"`, `"EXPORT"`, `"ABSENCE_BATCH"`, `"VARIABLE_BATCH"`, `"OC_FICHE"`, `"BPIJ"`, `"SIGNATURE_AUDIT_TRAIL"`, `"OTHER"`
  - `mimeType` (`listDocuments.response.200.data.mimeType`; any of, required) — Type MIME du fichier, `application/octet-stream` pour un format que Puncto ne connaît pas (docx, xlsx...)
    - any of: `ImageMimeType`, `OtherMimeType`
  - `collaboratorId` (`listDocuments.response.200.data.collaboratorId`; any of, required) — Collaborateur concerné, null pour un document de l'entreprise
    - any of: `string`, `null`
  - `collaboratorForeignErpId` (`listDocuments.response.200.data.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné ou sans collaborateur
  - `createdAt` (`listDocuments.response.200.data.createdAt`; string, required) — Date d'enregistrement du document dans Puncto
    - format `date-time`
  - `updatedAt` (`listDocuments.response.200.data.updatedAt`; string, required) — Date de la dernière modification, par exemple le remplacement du fichier par un nouvel envoi
    - format `date-time`
- `meta` (`listDocuments.response.200.meta`; object, required)
  - `total` (`listDocuments.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listDocuments.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listDocuments.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listDocuments.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listDocuments.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listDocuments.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` (`listDocuments.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listDocuments.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` (`listDocuments.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listDocuments.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Collaborateur du filtre introuvable

#### Example

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

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


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