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

Sujets

Server

Liste des sujets

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

Retourne la liste paginée des sujets avec leurs statistiques

Liste des sujets › query Parameters

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

Filtrer par catégorie

search
​string

Recherche dans le label

featured
​boolean

Filtrer les sujets mis en avant

Liste des sujets › Responses

200

Default Response

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

Sujets mis en avant

GET
https://api.clair.vote
/api/v1/sujets/featured

Retourne les sujets featured pour la homepage

Sujets mis en avant › query Parameters

limit
​integer · min: 1 · max: 20
Default: 6

Sujets mis en avant › Responses

200

Default Response

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

Liste des catégories

GET
https://api.clair.vote
/api/v1/sujets/categories

Retourne toutes les catégories de sujets avec leur count

Liste des catégories › Responses

200

Default Response

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

Détail d'un sujet

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

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

Détail d'un sujet › path Parameters

slug
​string · required

Détail d'un sujet › Responses

200

Default Response

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

Destination d'un sujet désactivé

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

Pour un sujet désactivé, renvoie l'UID du dossier qui en est la meilleure cible de redirection permanente, ou null s'il n'en portait aucun. 404 si le slug est inconnu ou toujours actif.

Destination d'un sujet désactivé › path Parameters

slug
​string · required

Destination d'un sujet désactivé › Responses

200

Default Response

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

Documents liés à un sujet

GET
https://api.clair.vote
/api/v1/sujets/{slug}/documents-lies

Rapports d'information, missions d'application et textes non votés citant la loi du sujet. Absents de la liste des dossiers, qui exige au moins un scrutin.

Documents liés à un sujet › path Parameters

slug
​string · required

Documents liés à un sujet › Responses

200

Default Response

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

Dossiers d'un sujet

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

Retourne les dossiers législatifs associés à un sujet

Dossiers d'un sujet › path Parameters

slug
​string · required

Dossiers d'un sujet › query Parameters

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

Dossiers d'un sujet › Responses

200

Default Response

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

Parcours parlementaire d'un sujet

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

Les réunions de commission et les séances publiques où les textes de ce sujet ont été examinés, dans l’ordre, chaque étape nommant le texte concerné.

Parcours parlementaire d'un sujet › path Parameters

slug
​string · required

Parcours parlementaire d'un sujet › Responses

200

Default Response

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

Scrutins d'un sujet

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

Retourne les scrutins associés à un sujet avec pagination

Scrutins d'un sujet › path Parameters

slug
​string · required

Scrutins d'un sujet › query Parameters

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

Objet du vote (sur quoi on vote)

Enum values:
ensemble
article
amendement
credits
motion
declaration
autre

Scrutins d'un sujet › Responses

200

Default Response

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

Presse d'un sujet

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

Articles de presse récupérés en live via Google Actualités (cache ~3h). Liens-only.

Presse d'un sujet › path Parameters

slug
​string · required

Presse d'un sujet › Responses

200

Default Response

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

Stats d'un sujet

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

Retourne les statistiques de votes par groupe pour un sujet

Stats d'un sujet › path Parameters

slug
​string · required

Stats d'un sujet › Responses

200

Default Response

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

HomepageFeedback