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

Scrutins

Server

Votes à l'Assemblée nationale et au Sénat


Liste des scrutins

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

Retourne la liste paginée des scrutins (votes) à l'Assemblée nationale et au Sénat

Liste des scrutins › query Parameters

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

Filtrer par chambre

Enum values:
assemblee
senat
type
​string · enum

Mode de scrutin (comment on vote)

Enum values:
solennel
ordinaire
motion
nature
​string · enum

Objet du vote (sur quoi on vote) : ensemble du texte, article, amendement, crédits budgétaires, motion ou procédure, déclaration du Gouvernement

Enum values:
ensemble
article
amendement
credits
motion
declaration
autre
sort
​string · enum
Enum values:
adopte
rejete
tag
​string

Filtrer par thématique

importance
​integer · min: 1 · max: 5
dateFrom
​string · date
dateTo
​string · date
search
​string

Recherche dans le titre

Liste des scrutins › Responses

200

Default Response

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

Liste des tags

GET
https://api.clair.vote
/api/v1/scrutins/tags

Retourne tous les tags de scrutins avec leur count

Liste des tags › Responses

200

Default Response

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

Années disponibles

GET
https://api.clair.vote
/api/v1/scrutins/annees

Retourne les années pour lesquelles des scrutins existent, avec leur nombre, triées décroissantes.

Années disponibles › Responses

200

Default Response

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

Périodes institutionnelles disponibles

GET
https://api.clair.vote
/api/v1/scrutins/periodes

Retourne les périodes pour lesquelles des scrutins existent : législature à l'AN, session ordinaire au Sénat. Les bornes de dates sont calculées sur les scrutins réellement en base : filtrer sur [dateDebut, dateFin] renvoie donc exactement les scrutins de la période. Une période absente de la base n'est pas exposée.

Périodes institutionnelles disponibles › Responses

200

Default Response

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

Scrutins importants

GET
https://api.clair.vote
/api/v1/scrutins/importants

Retourne les scrutins les plus importants récents

Scrutins importants › query Parameters

limit
​integer · min: 1 · max: 50
Default: 10

Scrutins importants › Responses

200

Default Response

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

Détail d'un scrutin

GET
https://api.clair.vote
/api/v1/scrutins/{numero}

Retourne les informations détaillées d'un scrutin avec tous les votes

Détail d'un scrutin › path Parameters

numero
​integer · required

Numéro du scrutin

Détail d'un scrutin › query Parameters

chambre
​string · enum
Enum values:
assemblee
senat
Default: assemblee
session
​string

Session parlementaire (ex: 2024 pour Sénat, 17 pour AN)

Détail d'un scrutin › Responses

200

Default Response

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

Interventions d'un scrutin

GET
https://api.clair.vote
/api/v1/scrutins/{numero}/interventions

Retourne la liste paginée des interventions (débats, explications de vote) pour un scrutin

Interventions d'un scrutin › path Parameters

numero
​integer · required

Interventions d'un scrutin › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 50
Default: 10
chambre
​string · enum
Enum values:
assemblee
senat
Default: assemblee
session
​string

Session parlementaire (ex: 2024 pour Sénat)

sort
​string · enum
Enum values:
asc
desc
Default: asc
search
​string · maxLength: 200

Recherche dans le contenu ou le nom du parlementaire

type
​string · enum

Nature de la prise de parole. Le décompte par nature est toujours rendu dans meta.parType.

Enum values:
intervention
question
reponse_gouvernement
explication_vote

Interventions d'un scrutin › Responses

200

Default Response

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

Contenu complet d'une intervention

GET
https://api.clair.vote
/api/v1/scrutins/interventions/{id}

Retourne le texte intégral d'une intervention par son ID

Contenu complet d'une intervention › path Parameters

id
​string · uuid · required

Contenu complet d'une intervention › Responses

200

Default Response

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

Votes d'un scrutin

GET
https://api.clair.vote
/api/v1/scrutins/{numero}/votes

Retourne la liste paginée des votes pour un scrutin

Votes d'un scrutin › path Parameters

numero
​integer · required

Votes d'un scrutin › query Parameters

page
​integer · min: 1
Default: 1
limit
​integer · min: 1 · max: 100
Default: 50
chambre
​string · enum
Enum values:
assemblee
senat
Default: assemblee
session
​string

Session parlementaire (ex: 2024 pour Sénat)

position
​string · enum
Enum values:
pour
contre
abstention
absent
groupe
​string

Slug du groupe politique

Votes d'un scrutin › Responses

200

Default Response

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

Groupes politiquesLobbying