CLAIR API

Parlementaires

Server

Données sur tous les parlementaires (députés + sénateurs)


Liste des parlementaires

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

Retourne la liste paginée des parlementaires avec filtres et tri

Liste des parlementaires › 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 parlementaires › Responses

200

Default Response

No data returned

Liste des groupes politiques

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

Retourne les groupes politiques 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/parlementaires/legislatures

Liste des législatures pour lesquelles des mandats existent, 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/parlementaires/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/parlementaires/historique-carriere

Indique si le tri « carrière complète » diffère du tri « mandat en cours » dans cette chambre : 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 parlementaires

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

Compare 2 à 4 parlementaires par leurs statistiques

Comparer des parlementaires › query Parameters

slugs
​string · required

Slugs des parlementaires séparés par des virgules (2-4)

Comparer des parlementaires › Responses

200

Default Response

No data returned

Détail d'un parlementaire

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

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

Détail d'un parlementaire › path Parameters

slug
​string · required

Slug unique du parlementaire

Détail d'un parlementaire › query Parameters

include
​string

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

Détail d'un parlementaire › Responses

200

Default Response

No data returned

Statistiques d'un parlementaire

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

Retourne les statistiques calculées d'un parlementaire

Statistiques d'un parlementaire › path Parameters

slug
​string · required

Statistiques d'un parlementaire › Responses

200

Default Response

No data returned

Rang d'un parlementaire dans le classement

GET
https://api.clair.vote
/api/v1/parlementaires/{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 parlementaire dans le classement › path Parameters

slug
​string · required

Rang d'un parlementaire 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 parlementaire dans le classement › Responses

200

Default Response

No data returned

Votes d'un parlementaire

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

Retourne l'historique des votes d'un parlementaire

Votes d'un parlementaire › path Parameters

slug
​string · required

Votes d'un parlementaire › 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 parlementaire › Responses

200

Default Response

No data returned

Votes d'un parlementaire, par dossier législatif

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

Résume les votes d'un parlementaire 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 parlementaire, par dossier législatif › path Parameters

slug
​string · required

Votes d'un parlementaire, 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 parlementaire, par dossier législatif › Responses

200

Default Response

No data returned

Amendements d'un parlementaire

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

Retourne les amendements déposés par un parlementaire

Amendements d'un parlementaire › path Parameters

slug
​string · required

Amendements d'un parlementaire › 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 parlementaire › Responses

200

Default Response

No data returned

Amendements d'un parlementaire, par dossier législatif

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

Résume les amendements déposés ou cosignés par un parlementaire, 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 parlementaire, par dossier législatif › path Parameters

slug
​string · required

Amendements d'un parlementaire, 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 parlementaire, par dossier législatif › Responses

200

Default Response

No data returned

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

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

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

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

slug
​string · required

Interventions d'un parlementaire 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 parlementaire groupées par séance › Responses

200

Default Response

No data returned