# Liste des absences

**GET /absences**

Récupère la liste des absences de l'entreprise avec de nombreuses options de filtrage.

Cette route est particulièrement utile pour :
- Afficher le calendrier des absences d'équipe
- Filtrer les absences par collaborateur ou période
- Obtenir les absences du jour (pour un dashboard RH)

## Filtres de période

Plusieurs modes de filtrage temporel sont disponibles :

- **month + year** : Absences sur un mois calendaire (avec marge du mois précédent/suivant)
- **today** : Absences en cours aujourd'hui (distingue matin/après-midi)
- **from / to** : Filtrer par date de début ou fin exacte
- **inPeriod** : Absences chevauchant une période donnée

## Gestion des demi-journées

Les absences peuvent commencer ou finir en demi-journée :
- **full** : Journée entière
- **half-am** : Matin uniquement
- **half-pm** : Après-midi uniquement



## Servers
- Version 2 of the API: https://wuro.pro/api/v3.2 (Version 2 of the API)


## Authentication methods
- App id auth & App secret auth


## Parameters


### Query parameters
- **limit** (integer)
  Nombre maximum d'absences à retourner
- **skip** (integer)
  Nombre d'absences à ignorer (pagination)
- **sort** (string)
  Tri des résultats (ex. "from:-1" pour les plus récentes d'abord)
- **state** (string)
  Filtrer par état de l'absence :
  - **waiting** : En attente de validation
  - **accepted** : Validée
  - **rejected** : Refusée
  - **canceled** : Annulée par le collaborateur
  - **inactive** : Supprimée (soft delete)
- **positionTo** (string | array[string])
  Filtrer par poste concerné. Valeurs spéciales :
  - **all** : Tous les postes
  - **onlyActive** : Postes actifs uniquement
  - ID de poste pour un poste spécifique
  - Tableau d'IDs pour plusieurs postes
- **userTo** (string)
  Filtrer par utilisateur concerné
- **type** (string | array[string])
  Filtrer par type d'absence (peut être un tableau)
- **month** (integer)
  Mois pour le filtre calendrier (1-12). Requiert year.
- **year** (integer)
  Année pour le filtre calendrier. Requiert month.
- **today** (boolean)
  Si true, retourne uniquement les absences du jour en cours
- **from** (string(date-time))
  Filtrer par date de début (format ISO)
- **to** (string(date-time))
  Filtrer par date de fin (format ISO)
- **inPeriod** (array[string(date-time)])
  Tableau de 2 dates [début, fin] pour obtenir les absences chevauchant cette période.
  Utile pour le calendrier : récupère les absences qui commencent, finissent ou traversent la période.


## Responses
### 200
Liste des absences avec pagination

#### Body: application/json (object)
- **absences** (array[object])
  Tableau des absences correspondant aux filtres
- **total** (integer)
  Nombre total d'absences (avant pagination)
- **limit** (integer)
  Limite utilisée
- **skip** (integer)
  Offset utilisé

### 403
Non autorisé - Accès aux absences refusé


[Powered by Bump.sh](https://bump.sh)