{"openapi":"3.1.0","info":{"title":"API Firma v1","version":"1.0.0","description":"API d'agrégation des données publiques d'entreprises. France : INSEE, INPI, BODACC. Autres pays : registres ouverts (NO, FI, CZ, SK, LT, BG, US SEC, CA fédéral, SG, TW, IL, KRS). Lecture : cookie de session ou Bearer `ppr_live_…`. Mutations (POST/DELETE) : Bearer uniquement."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Clé API ppr_live_… ou ppr_test_…"},"cookieAuth":{"type":"apiKey","in":"cookie","name":"better-auth.session_token"}}},"security":[{"bearerAuth":[]},{"cookieAuth":[]}],"paths":{"/pays":{"get":{"summary":"Couverture des pays Pappers et accès réel aux registres","security":[]}},"/suggestions":{"get":{"summary":"Autocomplete entreprises","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"pays","in":"query","schema":{"type":"string","description":"Code ISO. Défaut FR."}}],"security":[]}},"/recherche":{"get":{"summary":"Recherche d'entreprises","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"pays","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"departement","in":"query","schema":{"type":"string"}},{"name":"activite_principale","in":"query","schema":{"type":"string"}},{"name":"etat_administratif","in":"query","schema":{"type":"string"}}]}},"/entreprise":{"get":{"summary":"Fiche entreprise agrégée","parameters":[{"name":"siren","in":"query","schema":{"type":"string"}},{"name":"pays","in":"query","schema":{"type":"string"}},{"name":"id","in":"query","schema":{"type":"string","description":"Identifiant de registre si pays ≠ FR."}}]}},"/recherche-dirigeants":{"get":{"summary":"Recherche de dirigeants","parameters":[{"name":"nom","in":"query","schema":{"type":"string"}},{"name":"prenoms","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}}]}},"/recherche-documents":{"get":{"summary":"Recherche de documents (actes / comptes / BODACC)","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}]}},"/recherche-publications":{"get":{"summary":"Recherche de publications BODACC","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"siren","in":"query","schema":{"type":"string"}},{"name":"famille","in":"query","schema":{"type":"string"}}]}},"/document/telechargement":{"get":{"summary":"Télécharge un acte ou un bilan INPI","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string"}}]}},"/entreprise/comptes":{"get":{"summary":"Comptes annuels structurés","parameters":[{"name":"siren","in":"query","required":true,"schema":{"type":"string"}},{"name":"annee","in":"query","schema":{"type":"string"}}]}},"/scoring":{"get":{"summary":"Indice de solidité publique (alias de /indice, ne constitue pas une notation de crédit)","deprecated":true,"parameters":[{"name":"siren","in":"query","required":true,"schema":{"type":"string"}}]}},"/indice":{"get":{"summary":"Indice de solidité publique (données ouvertes uniquement, pas un avis de solvabilité)","parameters":[{"name":"siren","in":"query","required":true,"schema":{"type":"string"}}]}},"/extraits":{"get":{"summary":"Extrait PDF Firma","parameters":[{"name":"siren","in":"query","required":true,"schema":{"type":"string"}}]}},"/suivi":{"get":{"summary":"Solde et usage de la clé API"}},"/companies/watch":{"get":{"summary":"Liste des entreprises surveillées (SireneWatch)"},"post":{"summary":"Abonner un SIREN à la surveillance (Bearer requis)","security":[{"bearerAuth":[]}]},"delete":{"summary":"Retirer un SIREN de la surveillance (Bearer requis)","security":[{"bearerAuth":[]}]}},"/companies/{siren}/events":{"get":{"summary":"Historique d'événements d'un SIREN surveillé"}},"/companies/{siren}/risk":{"get":{"summary":"Indice de solidité publique d'un SIREN (pas une notation de crédit)"}},"/webhooks":{"get":{"summary":"Lister les webhooks SireneWatch"},"post":{"summary":"Créer un webhook (secret affiché une fois, Bearer requis)","security":[{"bearerAuth":[]}]},"delete":{"summary":"Supprimer un webhook (Bearer requis)","security":[{"bearerAuth":[]}]}},"/events/changes":{"get":{"summary":"Flux d'événements des SIREN du compte"}}}}