{"openapi":"3.0.3","info":{"title":"BOFiP API","version":"1.0.0","description":"API REST exposant la doctrine fiscale française du BOFiP en JSON. Source : BOFiP — Etalab 2.0."},"servers":[{"url":"https://api.bofip.dev","description":"Production"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"paths":{"/v1/search":{"get":{"summary":"Recherche full-text FTS5","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"domaine","in":"query","schema":{"type":"string","example":"IS"}}],"responses":{"200":{"description":"OK"},"401":{"description":"Non authentifié"},"402":{"description":"Quota dépassé"}}}},"/v1/boi/{id}":{"get":{"summary":"Récupère un document BOI complet","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^BOI-[A-Z0-9-]+$"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Document inconnu"}}}},"/v1/boi/{id}/graph":{"get":{"summary":"Graphe de références croisées","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"depth","in":"query","schema":{"type":"integer","minimum":1,"maximum":3,"default":1}}],"responses":{"200":{"description":"OK"}}}},"/v1/plan/{chemin}":{"get":{"summary":"Navigation hiérarchique du plan de classement","parameters":[{"name":"chemin","in":"path","schema":{"type":"string","example":"IS/BASE/35/30"}}],"responses":{"200":{"description":"OK"}}}},"/v1/search/semantic":{"post":{"summary":"Recherche sémantique (Mistral embeddings + Vectorize)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string"},"top_k":{"type":"integer","default":10,"maximum":50}}}}}},"responses":{"200":{"description":"OK"},"403":{"description":"Tier Free non autorisé"}}}},"/v1/changes":{"get":{"summary":"Documents modifiés depuis une date","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK"}}}},"/v1/suggest":{"get":{"summary":"Autocomplete par titre","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}}],"responses":{"200":{"description":"OK"}}}},"/v1/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"OK"}}}},"/v1/stats":{"get":{"summary":"Statistiques publiques","security":[],"responses":{"200":{"description":"OK"}}}}}}