Copy page

Référence API

API Parlementaires, Députés & Sénateurs

👥 Endpoints Principaux

Méthode	Route	Description
GET	/api/v1/parlementaires	Liste paginée de tous les parlementaires (Assemblée + Sénat)
GET	/api/v1/deputes	Liste filtrée sur les députés de l'Assemblée nationale
GET	/api/v1/senateurs	Liste filtrée sur les sénateurs
GET	/api/v1/parlementaires/:slug	Fiche détaillée d'un élu (biographie, mandats, stats, résumé IA)
GET	/api/v1/parlementaires/:slug/votes	Historique de vote d'un parlementaire avec filtres
GET	/api/v1/parlementaires/:slug/amendements	Amendements déposés et cosignés par l'élu
GET	/api/v1/parlementaires/:slug/interventions	Prises de parole en séance et en commission
GET	/api/v1/parlementaires/compare	Comparateur d'activité entre deux parlementaires

---

🏛️ Filtres Supportés

• chambre : assemblee ou senat
• groupe : Slug du groupe politique (ex: ensemble-pour-la-republique ou rassemblement-national)
• departement : Numéro de département (ex: 78, 75, 2A, 974)
• actif : true (en exercice, défaut) ou false (anciens élus)
• search : Recherche textuelle sur le nom / prénom
• sort : Tri par nom, prenom, presence, loyaute, activite, amendements, interventions
• order : Ordre asc ou desc (défaut : asc)
• periode : mandat (défaut) ou carriere

---

📋 Exemple de Réponse JSON (GET /api/v1/parlementaires/yael-braun-pivet)

Code
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "slug": "yael-braun-pivet",
  "nom": "Braun-Pivet",
  "prenom": "Yaël",
  "sexe": "F",
  "chambre": "assemblee",
  "actif": true,
  "groupe": {
    "id": "e5f6a7b8-c9d0-1234-ef56-7890abcdef12",
    "slug": "ensemble-pour-la-republique",
    "chambre": "assemblee",
    "nom": "EPR",
    "nomComplet": "Ensemble pour la République",
    "couleur": "#FFB300",
    "position": "centre"
  },
  "circonscription": {
    "id": "f0e1d2c3-b4a5-6789-0123-456789abcdef",
    "departement": "78",
    "numero": 5,
    "nom": "Yvelines",
    "type": "circonscription"
  },
  "stats": {
    "presence": 92,
    "presenceSolennel": 95,
    "loyaute": 98,
    "participation": 342,
    "interventions": 1420,
    "amendements": {
      "proposes": 12,
      "adoptes": 4
    },
    "questions": 8
  }
}