Développeurs
Intégrez l'analyse financière dans vos outils
Une API REST simple, authentifiée par clé, avec des réponses JSON stables et documentées. Envoyez des documents, lancez des analyses, récupérez les rapports et les benchmarks, et recevez des webhooks signés quand un calcul se termine.
Authentification et quotas
Créez une clé depuis Paramètres → API (offres Pro et Business). Transmettez-la dans l'en-tête Authorization: Bearer ax_live_… Les permissions sont limitées par scopes (analyses:read, analyses:write, documents:write, benchmarks:read, listings:read, companies:read). Le quota par minute dépend de l'offre ; chaque analyse lancée consomme un crédit de l'organisation, exactement comme dans l'interface.
Points d'entrée
- POST /api/v1/documents — envoi multipart d'un FEC, grand livre, balance ou PDF ; renvoie le document analysé et un résumé des états
- POST /api/v1/analyses — crée et lance une analyse à partir d'identifiants de documents (et d'un profil d'entreprise facultatif)
- GET /api/v1/analyses/{id} — rapport complet : SIG, bilan et compte de résultat, ratios avec percentiles, capacité d'emprunt, valorisation, score, recommandations, prévisions
- GET /api/v1/analyses — liste paginée des analyses de l'organisation
- GET /api/v1/benchmarks/{naf} — médianes et quartiles du secteur, multiples de valorisation
- GET /api/v1/companies/search?q= — recherche dans le registre national des entreprises
- GET /api/v1/listings — annonces publiées de la place de marché (teasers anonymisés)
- GET /api/v1/usage — consommation de crédits et d'appels sur 30 jours
- GET /api/v1/openapi.json — spécification OpenAPI 3.1 à importer dans votre client
Webhooks
Déclarez une URL HTTPS et les événements souhaités (analysis.completed, analysis.failed, document.parsed, listing.published, offer.received, offer.accepted, deal.stage_changed). Chaque livraison est signée en HMAC-SHA256 dans l'en-tête X-Bilanea-Signature avec le secret affiché à la création ; les échecs sont réessayés cinq fois avec un délai croissant et consultables dans l'interface.
Exemple
Envoyer un FEC puis lancer l'analyse :
curl -X POST https://bilanea.com/api/v1/documents -H "Authorization: Bearer ax_live_…" -F files=@851234567FEC20251231.txt
curl -X POST https://bilanea.com/api/v1/analyses -H "Authorization: Bearer ax_live_…" -H "Content-Type: application/json" -d '{"documentIds":["…"],"company":{"name":"Atelier Lumière","nafCode":"47.59B"}}'
La réponse contient l'identifiant de l'analyse et le rapport complet dès que le calcul est terminé (quelques secondes pour un FEC).
FAQ
- Le rapport JSON est-il stable dans le temps ?
- Oui : les clés sont versionnées par le champ version du rapport. Les ajouts sont rétro-compatibles ; les changements de structure passent par un nouveau numéro de version majeure.
- Puis-je utiliser l'API pour mes propres clients ?
- Oui, avec l'offre Business ou Entreprise : le multi-organisation et les rôles permettent de facturer vos clients comme vous l'entendez.
Obtenez votre clé API
Disponible dès l'offre Pro, avec 50 analyses incluses par mois.