---
title: "Consulter un bulletin de paie"
description: "Renvoie les lignes du bulletin telles qu’imprimées sur le PDF du collaborateur : revenus bruts, cotisations regroupées, indemnités non soumises, autres retenues et totaux.\n\n- Dans les revenus bruts, une retenue est un montant négatif.\n- Un mois de paie rouvert puis clôturé de nouveau remplace ses bulletins par de nouveaux identifiants : les anciens renvoient `404`."
---

> 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/{payslipId}`

Renvoie les lignes du bulletin telles qu’imprimées sur le PDF du collaborateur : revenus bruts, cotisations regroupées, indemnités non soumises, autres retenues et totaux.

- Dans les revenus bruts, une retenue est un montant négatif.
- Un mois de paie rouvert puis clôturé de nouveau remplace ses bulletins par de nouveaux identifiants : les anciens renvoient `404`.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `payslipId` (`getPayslip.path.payslipId`; string, required) — Identifiant Puncto du bulletin.

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Bulletin de paie

#### Example

```json
{
  "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",
  "projection": {
    "period": {
      "year": 0,
      "month": 0
    },
    "collaborator": {
      "firstName": "string",
      "lastName": "string",
      "matriculeRh": "string"
    },
    "grossSalary": [
      {
        "name": "string",
        "base": 0,
        "employeeRate": 0,
        "employeeCharge": 0,
        "employerCharge": 0,
        "isTaxFreeIndemnity": true
      }
    ],
    "charges": [
      {
        "items": [
          {
            "name": "string",
            "base": 0,
            "employeeRate": 0,
            "employeeCharge": 0,
            "employerCharge": 0,
            "isTaxFreeIndemnity": true
          }
        ],
        "name": "string"
      }
    ],
    "taxFreeIndemnitiesAndDeductions": [
      {
        "items": [
          {
            "name": "string",
            "base": 0,
            "employeeRate": 0,
            "employeeCharge": 0,
            "employerCharge": 0,
            "isTaxFreeIndemnity": true
          }
        ],
        "name": "string"
      }
    ],
    "priorPeriodRegularisations": [
      {
        "sourceYear": 0,
        "sourceMonth": 0,
        "title": "string",
        "grossLines": [
          {
            "name": "string",
            "base": 0,
            "employeeRate": 0,
            "employeeCharge": 0,
            "employerCharge": 0,
            "isTaxFreeIndemnity": true
          }
        ],
        "charges": [
          {
            "items": [
              {}
            ],
            "name": "string"
          }
        ],
        "netItems": [
          {
            "name": "string",
            "base": 0,
            "employeeRate": 0,
            "employeeCharge": 0,
            "employerCharge": 0,
            "isTaxFreeIndemnity": true
          }
        ],
        "totals": {
          "gross": 0,
          "collaboratorContributions": 0,
          "employerContributions": 0,
          "netBeforeTaxes": 0
        }
      }
    ],
    "totals": {
      "subTotalGrossSalary": 0,
      "totalCotisationsCollaborator": 0,
      "totalCotisationsEmployer": 0,
      "netSocial": 0,
      "netBeforeTaxes": 0,
      "netAfterTaxes": 0,
      "netImposable": 0,
      "pas": {
        "base": 0,
        "rate": 0,
        "amount": 0
      }
    }
  }
}
```

- `payslipId` (`getPayslip.response.200.payslipId`; string, required) — Identifiant Puncto
- `collaboratorId` (`getPayslip.response.200.collaboratorId`; string, required) — Identifiant Puncto
- `collaboratorForeignErpId` (`getPayslip.response.200.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
- `contractId` (`getPayslip.response.200.contractId`; string, required) — Identifiant Puncto
- `year` (`getPayslip.response.200.year`; number, required)
- `month` (`getPayslip.response.200.month`; number, required) — 1-12, 1 = janvier
- `paymentDate` (`getPayslip.response.200.paymentDate`; string, required) — Date de paiement du salaire imprimée sur le bulletin
  - format `date`
- `createdAt` (`getPayslip.response.200.createdAt`; string, required)
  - format `date-time`
- `projection` (`getPayslip.response.200.projection`; object, required) — Projection du bulletin : exactement les lignes que le template imprime, en données pures. Le rendu (`payslip.tsx`, `gross-salary-rows.tsx`) est construit à partir d'elle, donc ce que relit un lecteur externe — LLM de contrôle, agent de diagnostic — est ce que le salarié a sous les yeux, sans réimplémenter la moindre règle d'affichage.
  - `period` (`getPayslip.response.200.projection.period`; object, required)
    - `year` (`getPayslip.response.200.projection.period.year`; number, required)
    - `month` (`getPayslip.response.200.projection.period.month`; number, required)
  - `collaborator` (`getPayslip.response.200.projection.collaborator`; object, required)
    - `firstName` (`getPayslip.response.200.projection.collaborator.firstName`; string, required)
    - `lastName` (`getPayslip.response.200.projection.collaborator.lastName`; string, required)
    - `matriculeRh` (`getPayslip.response.200.projection.collaborator.matriculeRh`; string | null, required)
  - `grossSalary` (`getPayslip.response.200.projection.grossSalary`; array<object>, required) — Bloc « Éléments de revenus bruts » ; les retenues y sont négatives.
    - `name` (`getPayslip.response.200.projection.grossSalary.name`; string, required) — Libellé imprimé
    - `base` (`getPayslip.response.200.projection.grossSalary.base`; number, optional) — Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération
    - `employeeRate` (`getPayslip.response.200.projection.grossSalary.employeeRate`; number, optional) — Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires
    - `employeeCharge` (`getPayslip.response.200.projection.grossSalary.employeeCharge`; number, optional) — Montant salarié, en euros
    - `employerCharge` (`getPayslip.response.200.projection.grossSalary.employerCharge`; number, optional) — Montant patronal, en euros
    - `isTaxFreeIndemnity` (`getPayslip.response.200.projection.grossSalary.isTaxFreeIndemnity`; boolean, optional) — Ligne des indemnités non soumises
  - `charges` (`getPayslip.response.200.projection.charges`; array<any of>, required) — Bloc « Cotisations et contributions sociales ».
    - any of: `object`, `object`
  - `taxFreeIndemnitiesAndDeductions` (`getPayslip.response.200.projection.taxFreeIndemnitiesAndDeductions`; array<any of>, required) — Blocs « Indemnités non soumises », « Intéressement » et « Autres retenues ».
    - any of: `object`, `object`
  - `priorPeriodRegularisations` (`getPayslip.response.200.projection.priorPeriodRegularisations`; array<object>, required) — Blocs « Régularisation MM/AAAA », entre les cotisations et les indemnités non soumises.
    - `sourceYear` (`getPayslip.response.200.projection.priorPeriodRegularisations.sourceYear`; number, required)
    - `sourceMonth` (`getPayslip.response.200.projection.priorPeriodRegularisations.sourceMonth`; number, required)
    - `title` (`getPayslip.response.200.projection.priorPeriodRegularisations.title`; string, required) — « Régularisation 02/2026 »
    - `grossLines` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines`; array<object>, required) — Écarts des lignes de revenus bruts, signés comme dans le bloc des revenus bruts
      - `name` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.name`; string, required) — Libellé imprimé
      - `base` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.base`; number, optional) — Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération
      - `employeeRate` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.employeeRate`; number, optional) — Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires
      - `employeeCharge` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.employeeCharge`; number, optional) — Montant salarié, en euros
      - `employerCharge` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.employerCharge`; number, optional) — Montant patronal, en euros
      - `isTaxFreeIndemnity` (`getPayslip.response.200.projection.priorPeriodRegularisations.grossLines.isTaxFreeIndemnity`; boolean, optional) — Ligne des indemnités non soumises
    - `charges` (`getPayslip.response.200.projection.priorPeriodRegularisations.charges`; array<any of>, required) — Écarts des cotisations, groupés et libellés comme le bloc des cotisations
      - any of: `object`, `object`
    - `netItems` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems`; array<object>, required) — Écarts des indemnités non soumises et des retenues : `employeeCharge` est l'effet signé sur le net
      - `name` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.name`; string, required) — Libellé imprimé
      - `base` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.base`; number, optional) — Base : montant en euros pour une cotisation, heures ou jours pour une ligne de rémunération
      - `employeeRate` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.employeeRate`; number, optional) — Taux salarial : en % pour une cotisation (3.68 = 3,68 %), en €/h pour le salaire de base et les heures supplémentaires
      - `employeeCharge` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.employeeCharge`; number, optional) — Montant salarié, en euros
      - `employerCharge` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.employerCharge`; number, optional) — Montant patronal, en euros
      - `isTaxFreeIndemnity` (`getPayslip.response.200.projection.priorPeriodRegularisations.netItems.isTaxFreeIndemnity`; boolean, optional) — Ligne des indemnités non soumises
    - `totals` (`getPayslip.response.200.projection.priorPeriodRegularisations.totals`; object, required)
      - `gross` (`getPayslip.response.200.projection.priorPeriodRegularisations.totals.gross`; number, required)
      - `collaboratorContributions` (`getPayslip.response.200.projection.priorPeriodRegularisations.totals.collaboratorContributions`; number, required)
      - `employerContributions` (`getPayslip.response.200.projection.priorPeriodRegularisations.totals.employerContributions`; number, required)
      - `netBeforeTaxes` (`getPayslip.response.200.projection.priorPeriodRegularisations.totals.netBeforeTaxes`; number, required)
  - `totals` (`getPayslip.response.200.projection.totals`; object, required)
    - `subTotalGrossSalary` (`getPayslip.response.200.projection.totals.subTotalGrossSalary`; number, required)
    - `totalCotisationsCollaborator` (`getPayslip.response.200.projection.totals.totalCotisationsCollaborator`; number, required)
    - `totalCotisationsEmployer` (`getPayslip.response.200.projection.totals.totalCotisationsEmployer`; number, required)
    - `netSocial` (`getPayslip.response.200.projection.totals.netSocial`; number, required)
    - `netBeforeTaxes` (`getPayslip.response.200.projection.totals.netBeforeTaxes`; number, required)
    - `netAfterTaxes` (`getPayslip.response.200.projection.totals.netAfterTaxes`; number, required)
    - `netImposable` (`getPayslip.response.200.projection.totals.netImposable`; number | null, required) — Net imposable du mois — distinct de la base PAS, qui peut être nulle (taux nul).
    - `pas` (`getPayslip.response.200.projection.totals.pas`; object, required)
      - `base` (`getPayslip.response.200.projection.totals.pas.base`; number, required)
      - `rate` (`getPayslip.response.200.projection.totals.pas.rate`; number, required)
      - `amount` (`getPayslip.response.200.projection.totals.pas.amount`; number, 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` (`getPayslip.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`getPayslip.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` (`getPayslip.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`getPayslip.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Bulletin introuvable, non validé ou remplacé

#### Example

```json
{
  "error": "Bulletin de paie non trouvé"
}
```

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


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