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

Référence technique

Authentification

Chaque requête porte ta clé : Authorization: Bearer dp_… (ou X-API-Key: dp_…). Sans clé valide, l'API répond 401.

GET /v1/mouvements

ParamètreValeursDéfaut
chambreassemblee, senat, europarltoutes
typearrivee, depart, transferttous
sourcesuivi (quotidien), archives (historique)toutes
depuis, jusquadate AAAA-MM-JJ, bornes inclusesaucune
eluidentifiant de l'élu : PA… (AN), matricule (Sénat), identifiant PEaucun
collabnom ou prénom du collaborateur, correspondance partielle, accents facultatifsaucun
groupecode(s) de groupe politique, séparés par des virgules (ex. GEST,LR) — cible et origineaucun
limit1 à 500100
offsetentier positif0

Tous ces filtres se combinent (ET). Exemple : ?chambre=senat&type=arrivee&depuis=2026-01-01.

Les résultats sont triés du plus récent au plus ancien. Pour tout parcourir, augmente offset de limit jusqu'à dépasser total. Pour essayer sans écrire de code, utilise le playground.

Réponse

{
  "total": 1284,
  "limit": 100,
  "offset": 0,
  "mouvements": [
    {
      "id": "3f9c2a71b0d4e8a1",
      "date_event": "2026-10-02",
      "chambre": "senat",
      "type": "transfert",
      "collab_nom": "MARTIN", "collab_prenom": "Léa", "collab_civilite": "Mme",
      "elu_id": "21093M", "elu_nom": "Yannick JADOT", "elu_groupe": "GEST",
      "elu_origine_nom": "…", "elu_origine_groupe": "…",
      "contexte": "", "source": "suivi", "confiance": "bot"
    }
  ],
  "licence": "ODbL 1.0",
  "attribution": "DataParl' (dataparl.fr), d'après les publications de l'Assemblée nationale et du Sénat"
}
  • type=transfert : elu_* désigne l'élu rejoint, elu_origine_* l'élu quitté.
  • contexte vaut elu_sortant ou elu_entrant quand le mouvement accompagne un changement d'élu (renouvellement, fin de mandat).
  • confiance=faible signale une date approximative (période sans archive).

GET /v1/status

Public, sans clé. Fraîcheur et volumes des données, pour synchroniser ou afficher un état :

{
  "statut": "ok",
  "version": "v1",
  "jour": "2026-10-10",
  "derniere_collecte": "2026-10-10",
  "mouvements_du_jour": 38,
  "mouvements_total": 128400,
  "affectations_actives": { "assemblee": 1250, "senat": 410, "europarl": 96 },
  "licence": "ODbL 1.0"
}

mouvements_total est une estimation ; mouvements_du_jour peut être null si le compteur n'est pas disponible. Les prochains endpoints (équipes, parcours, agrégats) sont spécifiés sur la feuille de route.

Quotas et erreurs

CodeSignification
400paramètre invalide (le message indique lequel)
401clé absente, invalide ou révoquée
429quota du jour atteint (1 000 requêtes), remis à zéro à minuit, heure de Paris
503données momentanément indisponibles, réessaie plus tard

Chaque réponse indique le quota dans X-RateLimit-Limit et X-RateLimit-Remaining.

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