Permis Online · Documentation API

Une API pour les contenus de Permis Online

Recherche une règle, filtre par région et récupère une fiche avec son texte, ses sources et sa date de vérification. L’accès public se fait en lecture seule, sans clé.

Ouvrir le document OpenAPI Essayer une requête

Commencer

Une première requête.

L’API renvoie du JSON par requête GET. Aucune clé n’est nécessaire pour consulter ces fiches publiques.

Adresse de base

Recherche de fichesOuvrir la réponse

GET https://permis.online/api/v1/facts?q=permis%20provisoire&region=wallonie&kind=fact&limit=10&offset=0

Cet exemple recherche « permis provisoire » en Wallonie, parmi les règles et démarches, avec dix résultats au maximum. La réponse contient results, total, limit et offset.

Les routes

Rechercher, lire, découvrir.

GET/api/v1/

Découvrir le catalogue

Les accès disponibles et les liens de documentation.

GET/api/v1/facts

Rechercher les fiches

La liste des fiches, filtrable et paginée.

GET/api/v1/facts/{id}

Lire une fiche

Le texte complet, le contexte, les sources et la date.

GET/api/v1/openapi.json

Consulter le contrat OpenAPI

La description structurée des routes, paramètres et réponses.

Affiner la recherche

Les paramètres utiles.

Paramètres de GET /api/v1/facts
Paramètre	Usage	Exemple
`q`	Mot ou expression, jusqu’à 300 caractères. Sans ce paramètre, l’API liste les fiches.	`permis provisoire`
`region`	`wallonie`, `bruxelles`, `flandre` ou `belgique`. Cette dernière valeur sélectionne les fiches nationales. Sans filtre : tout le corpus.	`wallonie`
`kind`	`fact`, `expertise`, `organization`, `person`, `offer`, `professional`, `article`, `lesson`, `page` ou `tool`.	`fact`
`limit`	De 1 à 50 fiches par réponse. Valeur par défaut : 10.	`10`
`offset`	Nombre de résultats à passer, de 0 à 10 000. Commence à zéro, puis avance selon le nombre de résultats déjà lus.	`0`

Le document OpenAPI précise les valeurs acceptées et les réponses.

Rythme des requêtes

La limite est de 120 requêtes par minute et par adresse IP. En cas de réponse 429, attends le délai indiqué par l’en-tête Retry-After avant de recommencer.

Lire et citer

Retrouver une fiche précise.

Conserve l’identifiant retourné par la recherche pour demander la fiche complète. La réponse est directement l’objet de la fiche. Le champ url pointe vers sa version lisible.

Requête par identifiantOuvrir la fiche JSON

GET https://permis.online/api/v1/facts/fait-f2a7c629fbe649c3

Extrait des champs d’une fiche réelle

{
    "id": "fait-f2a7c629fbe649c3",
    "title": "Format de l'examen théorique",
    "url": "https://permis.online/brand-facts/#fait-f2a7c629fbe649c3",
    "kind": "fact",
    "regions": [
        "Belgique"
    ],
    "verified_at": "2026-09-18",
    "verification_scope": "Format ordinaire du théorique B, âge, nombre de questions, temps de réponse et séances adaptées."
}

Les sources font partie de la réponse

Les champs text, sources et verification_scope permettent de lire la fiche et de comprendre ce que ses références documentent. Conserve aussi regions, verified_at et, lorsqu’il est présent, evidence_kind, qui distingue notamment une analyse, une méthode ou une déclaration. Le champ modified_at indique une modification de publication, pas une vérification factuelle. Les documents related apportent un contexte complémentaire à lire avant de répondre.

Toujours retrouver l’origine

Des fiches consultables par tous.

Chaque information peut être relue sur le site, avec les références qui l’accompagnent.

Fiches de référence Sources et bibliographie Observatoire du permis belge Espace presse