DataParl' API
DocumentationDonnéesRéutilisationsMon espace APILe site
☰
DocumentationDonnéesRéutilisationsMon espace APILe site
Vue d'ensembleTechniquePlaygroundCas d'usageMachinesExemples de codeMCPFeuille de route

Feuille de route

Endpoints prévus, avec leur spécification cible. Ils suivront les mêmes conventions que l'API actuelle : JSON, dates ISO, identifiants stables, licence ODbL, clés et quotas partagés. Ton besoin déborde de ce cadre ? Écris-nous via le formulaire de contact du site principal.

GET /v1/elus/{id}/equipe — équipe actuelle d'un élu

La composition actuelle de l'équipe parlementaire d'un élu, à partir des affectations en cours.

{
  "elu": {
    "id": "PA795076", "nom": "Julien DIVE", "chambre": "assemblee", "groupe": "LR"
  },
  "collaborateurs": [
    {
      "cle": "petit_theo", "nom": "PETIT", "prenom": "Théo", "civilite": "M.",
      "fonction": "Chef de cabinet", "depuis": "2024-07-01"
    }
  ],
  "licence": "ODbL 1.0",
  "attribution": "DataParl' (dataparl.fr), d'après les publications de l'Assemblée nationale et du Sénat"
}

GET /v1/collaborateurs/{cle} — parcours d'un collaborateur

Tous les mouvements d'un collaborateur, du plus récent au plus ancien : son parcours complet entre élus et chambres. cle est la clé normalisée (sans accents) déjà présente dans les réponses de /v1/mouvements (champ collab_cle).

{
  "collaborateur": { "cle": "petit_theo", "nom": "PETIT", "prenom": "Théo" },
  "total": 4,
  "mouvements": [
    {
      "id": "3f9c2a71b0d4e8a1", "date_event": "2026-10-10", "chambre": "assemblee",
      "type": "arrivee", "elu_nom": "Julien DIVE", "elu_groupe": "LR", "fonction": "Assistant parlementaire"
    }
  ],
  "licence": "ODbL 1.0"
}

GET /v1/mouvements/stats — agrégats

Séries agrégées par mois et par chambre ou groupe : arrivées, départs, transferts. Évite de télécharger toute l'histoire pour un simple indicateur de turnover.

{
  "granularite": "mois",
  "depuis": "2026-01-01", "jusqua": "2026-10-10",
  "serie": [
    { "mois": "2026-09", "chambre": "assemblee", "arrivees": 142, "departs": 96, "transferts": 18 },
    { "mois": "2026-09", "chambre": "senat", "arrivees": 21, "departs": 14, "transferts": 3 }
  ],
  "licence": "ODbL 1.0"
}

Filtres prévus : chambre, groupe, depuis, jusqua, granularite=mois|annee.

GET /v1/groupes — harmonisation des groupes

Référentiel des groupes par chambre, avec les renommages au fil du temps (ex. FN → RN, ALDE → Renew), pour interpréter elu_groupe dans les séries longues.

{
  "groupes": [
    { "chambre": "assemblee", "code": "RN", "nom": "Rassemblement National",
      "precedents": [{ "code": "FN", "jusqua": "2018-06-01" }] }
  ],
  "licence": "ODbL 1.0"
}

Priorités

  1. Équipes d'élus (/v1/elus/{id}/equipe)
  2. Parcours collaborateur (/v1/collaborateurs/{cle})
  3. Agrégats (/v1/mouvements/stats)
  4. Référentiel groupes (/v1/groupes)
  5. Export bulk périodique (CSV/Parquet) annoncé sur data.gouv.fr

Ces spécifications sont indicatives : les champs peuvent évoluer avant la mise en service. Chaque ajout d'endpoint sera annoncé ici et versionné dans /v1/openapi.json.

© 2026 DataParl' API : DataParl' au format brut.
Plan du siteInformations légales