REST endpoints with predictable schemas, idempotent writes, and sandbox keys. So finance and engineering can integrate without shadow spreadsheets.
All API requests must be authenticated using a Bearer token passed in the Authorization header. You can generate API keys inside the LedgerOS Developer settings console. Keep secret keys secure.
API calls are limited to 1,000 requests per minute on production keys and 100 requests per minute on sandbox keys. Headers return remaining limits on every execution response.
We support sandbox mode to safely run simulations without impacting active accounts. Toggle endpoints by changing the subdomain from api to sandbox.
Execute a financial simulation against a defined set of assumptions. Supports modifying churn, acquisition costs, and pricing tiers simultaneously.
curl-X POST https://api.ledgeros.com/v1/simulations/run \
-H "Authorization: Bearer ck_live_..." \
-H "Content-Type: application/json" \
-d '{
"scenario": "increase_pricing_v2",
"mrr_growth_rate": 1.15,
"churn_impact": 0.02
}'
Retrieve historical and projected Monthly Recurring Revenue (MRR) based on active customer cohort data and configured pricing schemas.
{
"status": "success",
"data": {
"current_mrr": 124500.00,
"projected_mrr_12mo": 380200.00,
"currency": "INR"
}
}Fetch real-time synchronized cloud costs from linked AWS, GCP, Azure, or Vercel accounts to run continuous gross margin calculations.
curl-X GET https://api.ledgeros.com/v1/costs/cloud?provider=aws \
-H "Authorization: Bearer ck_live_..."
Scan linked infrastructure configs to identify architectural wastage, redundant nodes, or log-level spikes, returning automated recommendations to optimize costs.
curl-X POST https://api.ledgeros.com/v1/budgets/optimize \
-H "Authorization: Bearer ck_live_..." \
-H "Content-Type: application/json" \
-d '{
"provider": "aws",
"max_actionable_items": 5
}'
Retrieve a list of all custom-configured financial scenarios, projections, variables, and Monte Carlo settings configured on your account.
{
"status": "success",
"data": {
"count": 2,
"items": [
{ "id": "increase_pricing_v2", "name": "Tier 2 Pricing Lift" },
{ "id": "hire_5_devs", "name": "Engineering Scale-up" }
]
}
}