CLAIR API

Députés

Server

Données sur les députés de l'Assemblée nationale


Liste des députés

GET
https://api.clair.vote
/api/v1/deputes/

Retourne la liste paginée des députés avec filtres et tri

Liste des députés › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 200
Default: 20
chambre
​string · enum

Filtrer par chambre

Enum values:
assemblee
senat
groupe
​string

Slug du groupe politique

departement
​string

Numéro du département

search
​string

Recherche par nom/prénom

actif
​boolean
Default: true
sort
​string · enum
Enum values:
nom
prenom
presence
loyaute
activite
amendements
interventions
Default: nom
order
​string · enum
Enum values:
asc
desc
Default: asc

Liste des députés › Responses

200

Default Response

No data returned

Liste des groupes politiques

GET
https://api.clair.vote
/api/v1/deputes/groupes

Retourne les groupes politiques de députés d'une période, avec leur effectif. Un sigle de groupe n'existe qu'à un instant donné : par défaut, seule la législature courante de l'Assemblée est renvoyée. Le Sénat n'a pas de législature.

Liste des groupes politiques › query Parameters

legislature
​integer

Législature AN (15, 16, 17). Défaut : la plus récente en base.

session
​string

Session Sénat (année de début, ex. "2020"). Défaut : la session courante. L'effectif renvoyé est la composition du groupe à cette session.

Liste des groupes politiques › Responses

200

Default Response

No data returned

Législatures disponibles

GET
https://api.clair.vote
/api/v1/deputes/legislatures

Liste des législatures pour lesquelles des mandats existent (députés), de la plus récente à la plus ancienne, avec le nombre de mandats.

Législatures disponibles › Responses

200

Default Response

No data returned

Sessions disponibles (Sénat)

GET
https://api.clair.vote
/api/v1/deputes/sessions

Sessions ordinaires (1er oct. → 30 sept.) pour lesquelles la composition du Sénat est connue de façon fiable, de la plus récente à la plus ancienne. Le Sénat n'ayant pas de législature (renouvellement par moitiés), la session est le seul axe décrivant la chambre à un instant donné. Vide pour l'Assemblée (utiliser /legislatures).

Sessions disponibles (Sénat) › Responses

200

Default Response

No data returned

Historique de carrière disponible

GET
https://api.clair.vote
/api/v1/deputes/historique-carriere

Indique si le tri « carrière complète » diffère du tri « mandat en cours » dans cette chambre (députés) : vrai seulement s'il existe un élu en fonction réélu (≥ 2 mandats). Sert à afficher le sélecteur de période des classements uniquement quand il départage réellement les élus.

Historique de carrière disponible › Responses

200

Default Response

No data returned

Comparer des députés

GET
https://api.clair.vote
/api/v1/deputes/compare

Compare 2 à 4 députés par leurs statistiques

Comparer des députés › query Parameters

slugs
​string · required

Slugs des députés séparés par des virgules (2-4)

Comparer des députés › Responses

200

Default Response

No data returned

Détail d'un député

GET
https://api.clair.vote
/api/v1/deputes/{slug}

Retourne les informations détaillées d'un député

Détail d'un député › path Parameters

slug
​string · required

Slug unique du parlementaire

Détail d'un député › query Parameters

include
​string

Relations à inclure (votes,interventions,amendements,stats)

Détail d'un député › Responses

200

Default Response

No data returned

Statistiques d'un député

GET
https://api.clair.vote
/api/v1/deputes/{slug}/stats

Retourne les statistiques calculées d'un député

Statistiques d'un député › path Parameters

slug
​string · required

Statistiques d'un député › Responses

200

Default Response

No data returned

Rang d'un député dans le classement

GET
https://api.clair.vote
/api/v1/deputes/{slug}/rank

Retourne la position (1-based) du parlementaire dans le classement trié et le total, pour le deep-link vers /classements.

Rang d'un député dans le classement › path Parameters

slug
​string · required

Rang d'un député dans le classement › query Parameters

sort
​string · enum
Enum values:
nom
prenom
presence
loyaute
activite
amendements
interventions
Default: presence
order
​string · enum
Enum values:
asc
desc
Default: desc
chambre
​string · enum
Enum values:
assemblee
senat
groupe
​string

Rang d'un député dans le classement › Responses

200

Default Response

No data returned

Votes d'un député

GET
https://api.clair.vote
/api/v1/deputes/{slug}/votes

Retourne l'historique des votes d'un député

Votes d'un député › path Parameters

slug
​string · required

Votes d'un député › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 100
Default: 20
position
​string · enum
Enum values:
pour
contre
abstention
absent
tag
​string

Filtrer par tag de scrutin

dateFrom
​string · date
dateTo
​string · date
dissidentOnly
​boolean

Afficher uniquement les votes dissidents

Default: false
chambre
​string · enum

Chambre, pour un parlementaire passé par les deux

Enum values:
assemblee
senat
dossier
​string · maxLength: 64

Uid du dossier législatif des scrutins (DLR5L17N…), ou aucun pour les scrutins sans dossier

nature
​string · enum

Ce sur quoi porte le vote : ensemble du texte, article, amendement, crédits, motion…

Enum values:
ensemble
article
amendement
credits
motion
declaration
autre

Votes d'un député › Responses

200

Default Response

No data returned

Votes d'un député, par dossier législatif

GET
https://api.clair.vote
/api/v1/deputes/{slug}/votes/dossiers

Résume les votes d'un député dossier par dossier, du plus récemment voté au plus ancien : nombre de votes, positions, votes contraires à la majorité de son groupe, répartition par nature et votes sur l'ensemble du texte. Les scrutins sans dossier (motions de censure, demandes de suspension…) forment un dernier groupe, dossier: null. Le détail d'un dossier : /votes?dossier=<uid> (ou dossier=aucun).

Votes d'un député, par dossier législatif › path Parameters

slug
​string · required

Votes d'un député, par dossier législatif › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 50
Default: 20
dateFrom
​string · date
dateTo
​string · date
dissidentOnly
​boolean

Ne garder que les votes contraires à la majorité du groupe, et les dossiers qui en ont

Default: false
chambre
​string · enum

Chambre, pour un parlementaire passé par les deux

Enum values:
assemblee
senat

Votes d'un député, par dossier législatif › Responses

200

Default Response

No data returned

Amendements d'un député

GET
https://api.clair.vote
/api/v1/deputes/{slug}/amendements

Retourne les amendements déposés par un député

Amendements d'un député › path Parameters

slug
​string · required

Amendements d'un député › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 50
Default: 20
sort
​string · enum
Enum values:
Adopté
Rejeté
Retiré
Non soutenu
Tombé
dateFrom
​string · date
dateTo
​string · date
votedOnly
​boolean
Default: false
chambre
​string · enum

Chambre, pour un parlementaire passé par les deux

Enum values:
assemblee
senat
dossier
​string · maxLength: 64

Uid du dossier législatif (DLR5L17N…), ou aucun pour les amendements sans dossier

Amendements d'un député › Responses

200

Default Response

No data returned

Amendements d'un député, par dossier législatif

GET
https://api.clair.vote
/api/v1/deputes/{slug}/amendements/dossiers

Résume les amendements déposés ou cosignés par un député, dossier par dossier, du dépôt le plus récent au plus ancien : nombre d'amendements et ce qu'il en est advenu, en quatre familles (adopte, rejete, non_vote : retiré, tombé, non soutenu ou irrecevable, attente : pas encore examiné ou sort inconnu). Les amendements sans dossier forment un dernier groupe, dossier: null. Le détail d'un dossier : /amendements?dossier=<uid> (ou dossier=aucun).

Amendements d'un député, par dossier législatif › path Parameters

slug
​string · required

Amendements d'un député, par dossier législatif › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 50
Default: 20
dateFrom
​string · date
dateTo
​string · date
votedOnly
​boolean

Seulement les amendements mis aux voix par scrutin public

Default: false
chambre
​string · enum

Chambre, pour un parlementaire passé par les deux

Enum values:
assemblee
senat

Amendements d'un député, par dossier législatif › Responses

200

Default Response

No data returned

Interventions d'un député groupées par séance

GET
https://api.clair.vote
/api/v1/deputes/{slug}/interventions

Retourne les interventions groupées par séance avec scrutins liés

Interventions d'un député groupées par séance › path Parameters

slug
​string · required

Interventions d'un député groupées par séance › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 20
Default: 10
type
​string · enum
Enum values:
question
intervention
explication_vote
reponse_gouvernement
interruption
dateFrom
​string · date
dateTo
​string · date
chambre
​string · enum

Chambre, pour un parlementaire passé par les deux

Enum values:
assemblee
senat

Interventions d'un député groupées par séance › Responses

200

Default Response

No data returned