---
title: "Télécharger le PDF d’un bulletin de paie"
description: "Renvoie le PDF remis au collaborateur, en pièce jointe (`Content-Disposition: attachment`).\n\nLe PDF est généré en arrière-plan à la clôture du mois : juste après, l’appel peut renvoyer `404` le temps de la génération."
---

> 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}/pdf`

Renvoie le PDF remis au collaborateur, en pièce jointe (`Content-Disposition: attachment`).

Le PDF est généré en arrière-plan à la clôture du mois : juste après, l’appel peut renvoyer `404` le temps de la génération.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

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

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

PDF du bulletin

#### Example

```text
string
```

### 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` (`downloadPayslipPdf.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`downloadPayslipPdf.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` (`downloadPayslipPdf.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`downloadPayslipPdf.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Bulletin introuvable, non validé ou remplacé, ou PDF en cours de génération

#### Example

```json
{
  "error": "Le PDF de ce bulletin n’est pas encore disponible"
}
```

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


Source: https://docs.puncto.fr/reference/payslips/download-pdf/index.md
