API REST (/v1)

L’API REST /v1 suit une convention par ressource : un endpoint par ressource, verbes HTTP standards. Base : https://api.insourcia.io.

Endpoints

Méthode	Chemin	Description
GET	/v1/me	Informations sur la clé API courante
GET	/v1/companies/search?q=...	Recherche de sociétés
GET	/v1/companies/{siren}	Fiche d’une société
GET	/v1/companies/{siren}/financials	Comptes annuels (compte de résultat, bilan)
GET	/v1/companies/{siren}/directors	Dirigeants
GET	/v1/companies/{siren}/events	Événements d’une société (BODACC, procédures, dépôts)
GET	/v1/companies/{siren}/graph	Graphe d’entités (actionnaires, filiales)
GET	/v1/companies/{siren}/risk	Score de crédit (abonnés)
GET	/v1/companies/{siren}/risk/history	Historique du score de crédit (abonnés)
GET	/v1/events/search?type=cession&departement=75	Recherche d’événements sur plusieurs sociétés (un filtre est requis)
GET	/v1/companies/batch?sirens=...	Fiches de plusieurs sociétés
GET	/v1/companies/batch/financials, /risk, /directors, /events, /graph	Les mêmes sections, par lot de SIREN
POST	/v1/companies/resolve	Rapprocher un lot de fiches (nom, code postal, site) de leur SIREN
POST	/v1/companies/enrich	Enrichir un lot de sociétés, rendu en tableau
GET	/v1/companies/directors/search	Recherche de dirigeants
POST	/v1/companies/directors/reveal-email	Révéler l’email professionnel d’un dirigeant (abonnés)
GET	/v1/news	Lire sa veille
POST	/v1/news/read	Marquer des signaux de veille comme lus
GET / POST	/v1/lists/companies	Lister les sociétés surveillées, en ajouter une
POST	/v1/lists/monitoring	Activer ou désactiver la surveillance d’une liste
GET / POST	/v1/saved-searches	Lister ou enregistrer une recherche

Paramètres, schémas et coûts de chaque endpoint : référence complète.

Authentification

curl https://api.insourcia.io/v1/me \
  -H "Authorization: Bearer isk_VOTRE_CLE"

Générez votre clé dans Paramètres > API / MCP.

Crédits

Chaque appel est débité en crédits selon la grille publique : 1 crédit par fiche, 0,1 par résultat de recherche. Coûts par opération, règles de décompte et erreurs 402 / 403 : Tarification et crédits.

Format de réponse

JSON brut, sans enveloppe (extrait de GET /v1/companies/552037806) :

{
  "siren": "552037806",
  "denomination": "VINCI",
  "forme_juridique": "Société anonyme à conseil d'administration (SA)",
  "statut": "ACTIVE",
  "siege": {
    "ville": "NANTERRE",
    "code_postal": "92000",
    "departement": "92"
  },
  "activite": {
    "code_ape": "70.10Z",
    "libelle": "Activités des sièges sociaux"
  },
  ...
}

Erreurs : message en anglais, et message_fr quand la phrase d’origine est en français.

{
  "error": "not_found",
  "message": "No company found for SIREN 000000000.",
  "message_fr": "Aucune entreprise trouvée pour le SIREN 000000000."
}

Quand utiliser REST plutôt que Tools RPC

• Vous écrivez du code backend (Node, Python, Go) et préférez des chemins lisibles.
• Vous enrichissez vos fiches une par une (un endpoint par consultation).
• Votre client HTTP ou votre CRM attend des réponses sans enveloppe.

Pour les agents IA et l’automatisation sans code, voir Tools RPC et le serveur MCP.