---
title: "Lister les types d’astreinte"
description: "Liste paginée des types d’astreinte, par libellé, avec leur contrepartie brute par période (`PERIOD`) ou par heure (`HOUR`). Une période d’astreinte désigne son type par `onCallTypeId`.\n\nLes types se gèrent dans Puncto (Équipe › Astreintes). `400` si le module des astreintes n’est pas activé."
---

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

`GET /public/v1/on-call-types`

Liste paginée des types d’astreinte, par libellé, avec leur contrepartie brute par période (`PERIOD`) ou par heure (`HOUR`). Une période d’astreinte désigne son type par `onCallTypeId`.

Les types se gèrent dans Puncto (Équipe › Astreintes). `400` si le module des astreintes n’est pas activé.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Query parameters

- `page` (`listOnCallTypes.query.page`; integer, optional) — Numéro de page, à partir de 1.
  - min 1; default `1`
- `perPage` (`listOnCallTypes.query.perPage`; integer, optional) — Nombre d’éléments par page, 200 au plus.
  - min 1; max 200; default `50`

## Code samples

### cURL

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

### TypeScript

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

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

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

print(response.text)
```

## Responses

### 200

Page de types d’astreinte

#### Example

```json
{
  "data": [
    {
      "onCallTypeId": "octy_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "label": "string",
      "compensation": {
        "mode": "FIXED_PER_UNIT",
        "unit": "PERIOD",
        "amount": 0
      },
      "isActive": true,
      "isUsed": true
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "perPage": 0,
    "currentPage": 0,
    "firstPage": 0,
    "lastPage": 0
  }
}
```

- `data` (`listOnCallTypes.response.200.data`; array<object>, required)
  - `onCallTypeId` (`listOnCallTypes.response.200.data.onCallTypeId`; string, required) — Identifiant Puncto du type d'astreinte, à passer en `onCallTypeId` à l'import des périodes
  - `label` (`listOnCallTypes.response.200.data.label`; string, required) — Libellé, unique dans l'entreprise : utilisable en `onCallTypeLabel` à l'import des périodes
  - `compensation` (`listOnCallTypes.response.200.data.compensation`; object, required) — Contrepartie copiée sur chaque période à son import : modifier le barème ne change pas les périodes déjà enregistrées
    - `mode` (`listOnCallTypes.response.200.data.compensation.mode`; string, required) — Mode de calcul de la contrepartie : un montant fixe par unité, seul mode disponible
    - `unit` (`listOnCallTypes.response.200.data.compensation.unit`; string, required) — Unité décomptée : la période entière (`PERIOD`, une nuit, un week-end...), dont le nombre est importé avec la période, ou l'heure d'astreinte (`HOUR`), calculée sur la durée de la période
      - one of `"PERIOD"`, `"HOUR"`
    - `amount` (`listOnCallTypes.response.200.data.compensation.amount`; number, required) — Montant brut par unité, en euros
  - `isActive` (`listOnCallTypes.response.200.data.isActive`; boolean, required) — Un type désactivé ne sert plus aux nouvelles périodes ; celles déjà importées le gardent
  - `isUsed` (`listOnCallTypes.response.200.data.isUsed`; boolean, required) — Au moins une période d'astreinte utilise ce type
- `meta` (`listOnCallTypes.response.200.meta`; object, required)
  - `total` (`listOnCallTypes.response.200.meta.total`; integer, required) — Nombre total d’éléments.
  - `page` (`listOnCallTypes.response.200.meta.page`; integer, required) — Page renvoyée.
  - `perPage` (`listOnCallTypes.response.200.meta.perPage`; integer, required)
  - `currentPage` (`listOnCallTypes.response.200.meta.currentPage`; integer, required)
  - `firstPage` (`listOnCallTypes.response.200.meta.firstPage`; integer, required)
  - `lastPage` (`listOnCallTypes.response.200.meta.lastPage`; integer, required)

### 400

Astreintes non activées pour l’entreprise

#### Example

```json
{
  "error": "Les astreintes ne sont pas activées pour cette entreprise."
}
```

- `error` (`listOnCallTypes.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`listOnCallTypes.response.400.errorCode`; string, optional) — Code stable, sur certaines erreurs.

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


Source: https://docs.puncto.fr/reference/on-call-types/list/index.md
