API REST resource (/v1)

L’API REST /v1 suit la convention resource-style. Un endpoint par ressource, verbes HTTP standards.

Endpoints

Méthode	Path	Description
GET	/v1/me	Info de la clé API courante
GET	/v1/companies/search?q=...	Recherche d’entreprises
GET	/v1/companies/{siren}	Fiche entreprise
GET	/v1/companies/{siren}/financials	Données financières (P&L, bilan)
GET	/v1/companies/{siren}/directors	Liste des dirigeants
GET	/v1/announcements/search?type=vente	Annonces BODACC

Référence interactive complète sur /docs.

Authentification

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

Génère ta clé sur app.insourcia.io/settings.

Format de réponse

Brut, sans envelope :

{
  "siren": "552120222",
  "denomination": "VINCI",
  "code_ape": "7010Z",
  ...
}

Erreurs :

{
  "error": "not_found",
  "message": "Aucune entreprise trouvée pour le SIREN 000000000."
}

Quand utiliser REST plutôt que Tools RPC

• Tu écris du code backend traditionnel (Node, Python, Go) et préfères des paths intuitifs
• Tu fais de l’enrichment lead-by-lead (un endpoint par lookup)
• Ton client HTTP / CRM attend des réponses sans envelope

Pour les agents IA et automations no-code, voir Tools RPC.