---
title: "Lister les bulletins de paie"
description: "Liste paginée des bulletins validés (remis aux collaborateurs), du mois le plus récent au plus ancien puis par nom, avec leurs totaux. Les lignes se lisent avec `GET /public/v1/payslips/{payslipId}`, le PDF avec `GET /public/v1/payslips/{payslipId}/pdf`.\n\nUn filtre sans correspondance renvoie une liste vide."
---

> 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 › Bulletins de paie

`GET /public/v1/payslips`

Liste paginée des bulletins validés (remis aux collaborateurs), du mois le plus récent au plus ancien puis par nom, avec leurs totaux. Les lignes se lisent avec `GET /public/v1/payslips/{payslipId}`, le PDF avec `GET /public/v1/payslips/{payslipId}/pdf`.

Un filtre sans correspondance renvoie une liste vide.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listPayslips.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listPayslips.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `year` (`listPayslips.query.year`; integer, optional) — Année de la période de paie.
  - min 2000; max 2100; example `2026`
- `month` (`listPayslips.query.month`; integer, optional) — Mois de la période de paie, de 1 (janvier) à 12.
  - min 1; max 12; example `9`
- `contractId` (`listPayslips.query.contractId`; string, optional) — Identifiant Puncto du contrat.
- `collaboratorId` (`listPayslips.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listPayslips.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/payslips \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de bulletins

#### Example

```json
{
  "data": [
    {
      "payslipId": "pays_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorForeignErpId": "string",
      "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "year": 0,
      "month": 0,
      "paymentDate": "2019-08-24",
      "createdAt": "2019-08-24T14:15:22Z",
      "totals": {
        "subTotalGrossSalary": 0,
        "totalCotisationsCollaborator": 0,
        "totalCotisationsEmployer": 0,
        "netSocial": 0,
        "netBeforeTaxes": 0,
        "netAfterTaxes": 0,
        "netImposable": 0,
        "pas": {
          "base": 0,
          "rate": 0,
          "amount": 0
        }
      }
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listPayslips.response.200.data`; array<object>, required)
  - `payslipId` (`listPayslips.response.200.data.payslipId`; string, required) — Identifiant Puncto
  - `collaboratorId` (`listPayslips.response.200.data.collaboratorId`; string, required) — Identifiant Puncto
  - `collaboratorForeignErpId` (`listPayslips.response.200.data.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
  - `contractId` (`listPayslips.response.200.data.contractId`; string, required) — Identifiant Puncto
  - `year` (`listPayslips.response.200.data.year`; number, required)
  - `month` (`listPayslips.response.200.data.month`; number, required) — 1-12, 1 = janvier
  - `paymentDate` (`listPayslips.response.200.data.paymentDate`; string, required) — Date de paiement du salaire imprimée sur le bulletin
    - format `date`
  - `createdAt` (`listPayslips.response.200.data.createdAt`; string, required)
    - format `date-time`
  - `totals` (`listPayslips.response.200.data.totals`; object, required) — Totaux imprimés en pied de bulletin
    - `subTotalGrossSalary` (`listPayslips.response.200.data.totals.subTotalGrossSalary`; number, required)
    - `totalCotisationsCollaborator` (`listPayslips.response.200.data.totals.totalCotisationsCollaborator`; number, required)
    - `totalCotisationsEmployer` (`listPayslips.response.200.data.totals.totalCotisationsEmployer`; number, required)
    - `netSocial` (`listPayslips.response.200.data.totals.netSocial`; number, required)
    - `netBeforeTaxes` (`listPayslips.response.200.data.totals.netBeforeTaxes`; number, required)
    - `netAfterTaxes` (`listPayslips.response.200.data.totals.netAfterTaxes`; number, required)
    - `netImposable` (`listPayslips.response.200.data.totals.netImposable`; number | null, required) — Net imposable du mois — distinct de la base PAS, qui peut être nulle (taux nul).
    - `pas` (`listPayslips.response.200.data.totals.pas`; object, required)
      - `base` (`listPayslips.response.200.data.totals.pas.base`; number, required)
      - `rate` (`listPayslips.response.200.data.totals.pas.rate`; number, required)
      - `amount` (`listPayslips.response.200.data.totals.pas.amount`; number, required)
- `meta` (`listPayslips.response.200.meta`; object, required)
  - `total` (`listPayslips.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listPayslips.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listPayslips.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listPayslips.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listPayslips.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listPayslips.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` (`listPayslips.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listPayslips.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` (`listPayslips.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listPayslips.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` (`listPayslips.response.422.errors`; array<object>, required)
  - `message` (`listPayslips.response.422.errors.message`; string, required)
  - `rule` (`listPayslips.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`listPayslips.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


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