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

censure
​string · enum

Motions de censure seulement : toutes, spontanées (article 49, alinéa 2) ou en réponse à un 49.3 (alinéa 3)

Enum values:
toutes
alinea2
alinea3

Liste des scrutins › Responses

200

Default Response

No data returned

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

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

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

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

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

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

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

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