Developers
Embed financial analysis in your tools
A simple REST API, authenticated by key, with stable and documented JSON responses. Upload documents, run analyses, fetch reports and benchmarks, and receive signed webhooks when a computation completes.
Authentication and quotas
Create a key from Settings → API (Pro and Business plans). Send it in the Authorization: Bearer ax_live_… header. Permissions are limited by scopes (analyses:read, analyses:write, documents:write, benchmarks:read, listings:read, companies:read). The per-minute quota depends on the plan; each analysis run consumes one organisation credit, exactly as in the interface.
Endpoints
- POST /api/v1/documents — multipart upload of a ledger, trial balance or PDF; returns the parsed document and a statement summary
- POST /api/v1/analyses — creates and runs an analysis from document ids (and an optional company profile)
- GET /api/v1/analyses/{id} — full report: management balances, statements, ratios with percentiles, borrowing capacity, valuation, score, recommendations, forecasts
- GET /api/v1/analyses — paginated list of the organisation's analyses
- GET /api/v1/benchmarks/{naf} — sector medians and quartiles, valuation multiples
- GET /api/v1/companies/search?q= — search in the national company registry
- GET /api/v1/listings — published marketplace listings (anonymised teasers)
- GET /api/v1/usage — credit and call consumption over 30 days
- GET /api/v1/openapi.json — OpenAPI 3.1 specification to import in your client
Webhooks
Declare an HTTPS URL and the events you want (analysis.completed, analysis.failed, document.parsed, listing.published, offer.received, offer.accepted, deal.stage_changed). Each delivery is HMAC-SHA256 signed in the X-Bilanea-Signature header with the secret shown at creation; failures are retried five times with increasing delay and visible in the interface.
Example
Upload a ledger then run the analysis:
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"}}'
The response contains the analysis id and the full report as soon as the computation is done (a few seconds for a ledger).
FAQ
- Is the JSON report stable over time?
- Yes: keys are versioned by the report's version field. Additions are backward compatible; structural changes go through a new major version.
- Can I use the API for my own clients?
- Yes, with the Business or Enterprise plan: multi-organisation and roles let you bill your clients as you wish.
Get your API key
Available from the Pro plan, with 50 analyses included per month.