Firma

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 registres
  • GET /api/v1/suggestionsAutocomplete entreprises
  • GET /api/v1/rechercheRecherche d'entreprises
  • GET /api/v1/entrepriseFiche entreprise agrégée
  • GET /api/v1/recherche-dirigeantsRecherche de dirigeants
  • GET /api/v1/recherche-documentsRecherche de documents (actes / comptes / BODACC)
  • GET /api/v1/recherche-publicationsRecherche de publications BODACC
  • GET /api/v1/document/telechargementTélécharge un acte ou un bilan INPI
  • GET /api/v1/entreprise/comptesComptes annuels structurés
  • GET /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 Firma
  • GET /api/v1/suiviSolde et usage de la clé API
  • GET / 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 SireneWatch
  • GET /api/v1/events/changesFlux d'événements des SIREN du compte