CLAIR DocsCLAIR Docs
  • clair.vote
  • GitHub
  • Nous soutenir
Nous soutenir
  • Accueil
  • Plateforme & Guide
  • Données & Base de Données
  • Explorateur API
CLAIR

Plateforme citoyenne de transparence politique. Données 100% publiques, 0% d'opinion.

Explorer

  • Députés
  • Sénateurs
  • Groupes politiques
  • Sujets
  • Dossiers législatifs
  • Scrutins
  • Agenda
  • Lobbying

Ressources

  • Nous soutenir
  • À propos
  • Méthodologie
  • Contact
  • Comprendre
  • Guide pratique
  • API ouverte

Légal

  • Mentions légales
  • Confidentialité
  • CGU

© 2026 CLAIR. Sources : Assemblée nationale · Sénat · HATVP · Ministère de l'Intérieur · DILA

Information
Health
    Health checkgetReadiness checkgetLiveness checkget
Parlementaires
    Liste des parlementairesgetListe des groupes politiquesgetLégislatures disponiblesgetSessions disponibles (Sénat)getHistorique de carrière disponiblegetComparer des parlementairesgetDétail d'un parlementairegetStatistiques d'un parlementairegetRang d'un parlementaire dans le classementgetVotes d'un parlementairegetAmendements d'un parlementairegetInterventions d'un parlementaire groupées par séanceget
Députés
    Liste des députésgetListe des groupes politiquesgetLégislatures disponiblesgetSessions disponibles (Sénat)getHistorique de carrière disponiblegetComparer des députésgetDétail d'un députégetStatistiques d'un députégetRang d'un député dans le classementgetVotes d'un députégetAmendements d'un députégetInterventions d'un député groupées par séanceget
Sénateurs
    Liste des sénateursgetListe des groupes politiquesgetLégislatures disponiblesgetSessions disponibles (Sénat)getHistorique de carrière disponiblegetComparer des sénateursgetDétail d'un sénateurgetStatistiques d'un sénateurgetRang d'un sénateur dans le classementgetVotes d'un sénateurgetAmendements d'un sénateurgetInterventions d'un sénateur groupées par séanceget
Groupes politiques
    Liste des groupes politiquesgetDétail d'un groupe politiquegetStatistiques d'un groupegetStatistiques de votes du groupegetAlliances du groupegetStatistiques par thématiquegetMatrice d'alliances entre tous les groupesget
Scrutins
    Liste des scrutinsgetListe des tagsgetAnnées disponiblesgetPériodes institutionnelles disponiblesgetScrutins importantsgetDétail d'un scrutingetInterventions d'un scrutingetContenu complet d'une interventiongetVotes d'un scrutinget
Lobbying
    Liste des représentants d'intérêtsgetListe des secteursgetStatistiques du lobbyinggetDétail d'un lobbyistegetActions d'un lobbyistegetListe toutes les actions de lobbyinggetActions de lobbying récentesget
Search
    Recherche globalegetSuggestions de rechercheget
Analytics
    Statistiques globalesgetRépartition par groupegetTendances de votegetTop députésgetSecteurs de lobbyinggetScrutins avec statistiquesgetDéputés dissidentsgetThèmes de scrutinsgetScrutins controversésgetTop lobbyistesget
Dossiers
    Liste des dossiers législatifsgetValeurs de filtres disponiblesgetDossiers législatifs en tendancegetDétail d'un dossier législatifgetParcours d'un dossier législatifgetScrutins d'un dossier législatifgetAmendements d'un dossier législatifget
Commissions
    Liste des commissions parlementairesgetDétail d'une commissiongetRéunions d'une commissiongetDossiers législatifs d'une commissionget
Agenda
    Calendrier parlementairegetProchaines échéances institutionnellesgetDétail d'une réuniongetDébat d’une réunion, page par pageget
Senatoriales
    Aperçu du renouvellement sénatorial du 27 septembre 2026getBilan de mandature des sénateurs sortants (série 2)getCandidats au renouvellement du 27 septembre 2026getRésultats du 27 septembre 2026, circonscription par circonscriptiongetRésultats détaillés d'une circonscriptiongetSénateurs élus le 27 septembre 2026 qui ont une fiche provisoiregetFiche provisoire d'un sénateur élu le 27 septembre 2026get
Homepage
    Données agrégées pour la page d'accueilgetInvalider et recharger le cache homepagepost
Sujets
    Liste des sujetsgetSujets mis en avantgetListe des catégoriesgetDétail d'un sujetgetDestination d'un sujet désactivégetDocuments liés à un sujetgetDossiers d'un sujetgetParcours parlementaire d'un sujetgetScrutins d'un sujetgetPresse d'un sujetgetStats d'un sujetget
Feedback
    Envoyer un retour utilisateurpost
Sitemap
    Données minimales pour la génération du sitemapget
Other endpoints
    /robots.txtget
Ouvrir le Swagger UI
CLAIR API
CLAIR API

Sénateurs

Server

Données sur les sénateurs


Liste des sénateurs

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

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

Liste des sénateurs › 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 sénateurs › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/
curl https://api.clair.vote/api/v1/senateurs
Example Responses
No example specified for this content type

Liste des groupes politiques

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

Retourne les groupes politiques de sénateurs 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
GET/api/v1/senateurs/groupes
curl https://api.clair.vote/api/v1/senateurs/groupes
Example Responses
No example specified for this content type

Législatures disponibles

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

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

Législatures disponibles › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/legislatures
curl https://api.clair.vote/api/v1/senateurs/legislatures
Example Responses
No example specified for this content type

Sessions disponibles (Sénat)

GET
https://api.clair.vote
/api/v1/senateurs/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
GET/api/v1/senateurs/sessions
curl https://api.clair.vote/api/v1/senateurs/sessions
Example Responses
No example specified for this content type

Historique de carrière disponible

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

Indique si le tri « carrière complète » diffère du tri « mandat en cours » dans cette chambre (sénateurs) : 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
GET/api/v1/senateurs/historique-carriere
curl https://api.clair.vote/api/v1/senateurs/historique-carriere
Example Responses
No example specified for this content type

Comparer des sénateurs

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

Compare 2 à 4 sénateurs par leurs statistiques

Comparer des sénateurs › query Parameters

slugs
​string · required

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

Comparer des sénateurs › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/compare
curl 'https://api.clair.vote/api/v1/senateurs/compare?slugs=<string>'
Example Responses
No example specified for this content type

Détail d'un sénateur

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

Retourne les informations détaillées d'un sénateur

Détail d'un sénateur › path Parameters

slug
​string · required

Slug unique du parlementaire

Détail d'un sénateur › query Parameters

include
​string

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

Détail d'un sénateur › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}
curl https://api.clair.vote/api/v1/senateurs/:slug
Example Responses
No example specified for this content type

Statistiques d'un sénateur

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

Retourne les statistiques calculées d'un sénateur

Statistiques d'un sénateur › path Parameters

slug
​string · required

Statistiques d'un sénateur › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}/stats
curl https://api.clair.vote/api/v1/senateurs/:slug/stats
Example Responses
No example specified for this content type

Rang d'un sénateur dans le classement

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

slug
​string · required

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

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}/rank
curl https://api.clair.vote/api/v1/senateurs/:slug/rank
Example Responses
No example specified for this content type

Votes d'un sénateur

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

Retourne l'historique des votes d'un sénateur

Votes d'un sénateur › path Parameters

slug
​string · required

Votes d'un sénateur › 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

Votes d'un sénateur › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}/votes
curl https://api.clair.vote/api/v1/senateurs/:slug/votes
Example Responses
No example specified for this content type

Amendements d'un sénateur

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

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

Amendements d'un sénateur › path Parameters

slug
​string · required

Amendements d'un sénateur › 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

Amendements d'un sénateur › Responses

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}/amendements
curl https://api.clair.vote/api/v1/senateurs/:slug/amendements
Example Responses
No example specified for this content type

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

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

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

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

slug
​string · required

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

200

Default Response

No data returned
GET/api/v1/senateurs/{slug}/interventions
curl https://api.clair.vote/api/v1/senateurs/:slug/interventions
Example Responses
No example specified for this content type

DéputésGroupes politiques