API publique
API REST en lecture seule, sans clé. Chaque réponse JSON contient data et meta.provenance (version des données, date de publication, licence). Les listes sont paginées (page, pageSize jusqu'à 200). Limite : 120 requêtes par minute. Les réponses portent un ETag.
Description complète : /api/v1/openapi.json (OpenAPI 3.1).
| Point d'accès | Description |
|---|---|
| GET /api/v1/representatives | Rechercher des représentants |
| GET /api/v1/representatives/{id} | Fiche d'un représentant (identité, mandats, groupes, sources) |
| GET /api/v1/representatives/{id}/votes | Positions nominatives publiées et indicateurs |
| GET /api/v1/representatives/{id}/activities | Chronologie (mandats, groupes, textes, votes) |
| GET /api/v1/scrutins | Lister les scrutins |
| GET /api/v1/scrutins/{id} | Détail d'un scrutin et positions nominatives |
| GET /api/v1/legislation | Dossiers législatifs |
| GET /api/v1/legislation/{id} | Dossier législatif |
| GET /api/v1/territories | Communes (par nom, code postal ou code INSEE), départements, régions |
| GET /api/v1/territories/{code}/representatives | Représentants associés à une commune, avec la nature de la représentation |
| GET /api/v1/search | Recherche globale (code postal, commune, nom) |
| GET /api/v1/sources | Registre des sources, licences, fraîcheur et couverture |
| GET /api/v1/status | État de la dernière synchronisation |
Exemple
curl "https://mes-representants.fr/api/v1/search?q=33000" curl "https://mes-representants.fr/api/v1/scrutins?from=2025-01-01&type=SPS&format=csv"