Pour les intégrateurs
API Firma v1
Données publiques d'entreprises, plus SireneWatch : surveillance, événements, risque et webhooks. Clé ppr_live_… depuis votre compte.
curl "https://firma.argus-labs.fr/api/v1/companies/watch" \
-H "Authorization: Bearer ppr_live_…" \
-H "Content-Type: application/json" \
-d '{"siren":"443061841"}'SireneWatch
- On ne stocke que les SIREN que vous suivez, un snapshot, et l'historique d'événements.
- Ingest quotidien BODACC (flux du jour) + snapshot Sirene du portefeuille.
- Webhooks :
X-Firma-Signature: sha256=… et X-Firma-Timestamp (HMAC sur timestamp.raw_body), 3 tentatives. - Plan gratuit : 10 entreprises surveillées.
Crédits
/suggestions0 cr./recherche0.1 cr./entreprise1 cr./recherche-dirigeants0.1 cr./recherche-documents0.1 cr./recherche-publications0.1 cr./document/telechargement3 cr./entreprise/comptes2 cr./extraits3 cr./scoring0 cr./indice0 cr./suivi0 cr.
Sécurité
- Lecture API : cookie de session ou Bearer. Mutations POST/DELETE : Bearer uniquement.
- Clés hashées, affichées une seule fois
- OpenAPI : /api/v1/openapi.json
Routes
GET /api/v1/paysCouverture des pays Pappers et accès réel aux registresGET /api/v1/suggestionsAutocomplete entreprisesGET /api/v1/rechercheRecherche d'entreprisesGET /api/v1/entrepriseFiche entreprise agrégéeGET /api/v1/recherche-dirigeantsRecherche de dirigeantsGET /api/v1/recherche-documentsRecherche de documents (actes / comptes / BODACC)GET /api/v1/recherche-publicationsRecherche de publications BODACCGET /api/v1/document/telechargementTélécharge un acte ou un bilan INPIGET /api/v1/entreprise/comptesComptes annuels structurésGET /api/v1/scoringIndice de solidité publique (alias de /indice, ne constitue pas une notation de crédit)GET /api/v1/indiceIndice de solidité publique (données ouvertes uniquement, pas un avis de solvabilité)GET /api/v1/extraitsExtrait PDF FirmaGET /api/v1/suiviSolde et usage de la clé APIGET / POST / DELETE /api/v1/companies/watchListe des entreprises surveillées (SireneWatch)GET /api/v1/companies/{siren}/eventsHistorique d'événements d'un SIREN surveilléGET /api/v1/companies/{siren}/riskIndice de solidité publique d'un SIREN (pas une notation de crédit)GET / POST / DELETE /api/v1/webhooksLister les webhooks SireneWatchGET /api/v1/events/changesFlux d'événements des SIREN du compte