---
title: "Lister les variables récurrentes"
description: "Liste paginée des variables récurrentes de l’entreprise, de la plus ancienne à la plus récente : primes et avantages en nature mensuels, véhicules de fonction, abonnements annuels de transport public. `GET /public/v1/payroll-variables` ne les liste pas.\n\n`lockedThrough` est le dernier mois verrouillé (paie clôturée ou bulletin validé) que la variable a versé : dès lors, elle ne se supprime plus et seul son dernier mois de versement peut changer."
---

> 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 › Variables récurrentes

`GET /public/v1/recurring-variables`

Liste paginée des variables récurrentes de l’entreprise, de la plus ancienne à la plus récente : primes et avantages en nature mensuels, véhicules de fonction, abonnements annuels de transport public. `GET /public/v1/payroll-variables` ne les liste pas.

`lockedThrough` est le dernier mois verrouillé (paie clôturée ou bulletin validé) que la variable a versé : dès lors, elle ne se supprime plus et seul son dernier mois de versement peut changer.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listRecurringVariables.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listRecurringVariables.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`
- `contractId` (`listRecurringVariables.query.contractId`; string, optional) — Identifiant Puncto du contrat.
  - example `"cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorId` (`listRecurringVariables.query.collaboratorId`; string, optional) — Identifiant Puncto du collaborateur. Ne pas combiner avec `collaboratorForeignErpId`.
  - example `"coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`
- `collaboratorForeignErpId` (`listRecurringVariables.query.collaboratorForeignErpId`; string, optional) — Identifiant du collaborateur dans votre système (`foreignErpId`). Ne pas combiner avec `collaboratorId`.
  - example `"salarie-123"`
- `status[]` (`listRecurringVariables.query.status[]`; array<string>, optional) — Statuts à garder. Répétez le paramètre pour en passer plusieurs.
- `type[]` (`listRecurringVariables.query.type[]`; array<string>, optional) — Natures à garder (`data.type`). Répétez le paramètre pour en passer plusieurs.
- `foreignErpId` (`listRecurringVariables.query.foreignErpId`; string, optional) — Identifiant de la variable récurrente dans votre système.

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de variables récurrentes

#### Example

```json
{
  "data": [
    {
      "recurringVariableId": "rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "foreignErpId": "string",
      "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "collaboratorForeignErpId": "string",
      "data": {
        "type": "PRIME",
        "name": "string",
        "amount": 0,
        "primeType": "HOLIDAY_BONUS",
        "isAbsenceSensitive": true
      },
      "frequency": "MONTHLY",
      "status": "PENDING",
      "startYear": 0,
      "startMonth": 0,
      "endYear": 0,
      "endMonth": 0,
      "lockedThrough": {
        "year": 0,
        "month": 0
      },
      "proofFiles": [
        {
          "documentId": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
          "displayFileName": "string",
          "fileType": "PAYSLIP",
          "mimeType": "image/jpeg",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      ],
      "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` (`listRecurringVariables.response.200.data`; array<object>, required)
  - `recurringVariableId` (`listRecurringVariables.response.200.data.recurringVariableId`; string, required) — Identifiant Puncto de la variable récurrente
  - `foreignErpId` (`listRecurringVariables.response.200.data.foreignErpId`; string | null, required) — Identifiant de la variable récurrente dans votre système, null si elle n'a pas été importée
  - `contractId` (`listRecurringVariables.response.200.data.contractId`; string, required) — Contrat qui verse la variable
  - `collaboratorId` (`listRecurringVariables.response.200.data.collaboratorId`; string, required) — Collaborateur titulaire du contrat
  - `collaboratorForeignErpId` (`listRecurringVariables.response.200.data.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
  - `data` (`listRecurringVariables.response.200.data.data`; any of, required) — Ce que la variable verse chaque mois
    - any of: `PublicApiRecurringPrimeData`, `PublicApiRecurringInKindBenefitData`, `PublicApiAnnualPublicTransportData`
  - `frequency` (`listRecurringVariables.response.200.data.frequency`; string, required) — Périodicité des versements
  - `status` (`listRecurringVariables.response.200.data.status`; string, required) — Seule une variable validée (`VALIDATED`) est versée ; une variable en attente (`PENDING`) attend un administrateur
    - one of `"PENDING"`, `"VALIDATED"`, `"REJECTED"`
  - `startYear` (`listRecurringVariables.response.200.data.startYear`; number, required) — Année du premier mois de versement
  - `startMonth` (`listRecurringVariables.response.200.data.startMonth`; number, required) — Premier mois de versement, de 1 à 12
  - `endYear` (`listRecurringVariables.response.200.data.endYear`; number | null, required) — Année du dernier mois de versement, null tant que la variable court sans fin
  - `endMonth` (`listRecurringVariables.response.200.data.endMonth`; number | null, required) — Dernier mois de versement inclus, de 1 à 12, null tant que la variable court sans fin
  - `lockedThrough` (`listRecurringVariables.response.200.data.lockedThrough`; any of, required) — Dernier mois de la période déjà verrouillé (paie clôturée ou bulletin validé), null si aucun ou si la variable n'est pas validée. Une variable verrouillée ne se supprime plus et ne se modifie plus : seul son dernier mois de versement peut encore être fixé, après ce mois
    - any of: `PublicApiYearMonth`, `null`
  - `proofFiles` (`listRecurringVariables.response.200.data.proofFiles`; array<object>, required) — Justificatifs joints dans Puncto
    - `documentId` (`listRecurringVariables.response.200.data.proofFiles.documentId`; string, required) — Identifiant Puncto du document
    - `displayFileName` (`listRecurringVariables.response.200.data.proofFiles.displayFileName`; string, required) — Nom du document affiché dans Puncto
    - `fileType` (`listRecurringVariables.response.200.data.proofFiles.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` (`listRecurringVariables.response.200.data.proofFiles.mimeType`; any of, required) — Type MIME du fichier
      - any of: `ImageMimeType`, `OtherMimeType`
    - `createdAt` (`listRecurringVariables.response.200.data.proofFiles.createdAt`; string, required) — Date d'enregistrement du document dans Puncto
      - format `date-time`
  - `createdAt` (`listRecurringVariables.response.200.data.createdAt`; string, required) — Date de création dans Puncto
    - format `date-time`
  - `updatedAt` (`listRecurringVariables.response.200.data.updatedAt`; string, required) — Date de dernière modification dans Puncto
    - format `date-time`
- `meta` (`listRecurringVariables.response.200.meta`; object, required)
  - `total` (`listRecurringVariables.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listRecurringVariables.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listRecurringVariables.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listRecurringVariables.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listRecurringVariables.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listRecurringVariables.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` (`listRecurringVariables.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`listRecurringVariables.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` (`listRecurringVariables.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`listRecurringVariables.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Collaborateur du filtre introuvable

#### Example

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

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


Source: https://docs.puncto.fr/reference/recurring-variables/list/index.md
