Skip to main content

Clear Margins API

Financial health scores for the products your operators already use.

Send operating data from a CRM, inventory system, finance dashboard, or custom workflow. Clear Margins returns structured margin signals, triggers, and calculator outputs.

View Scale betaOpen dashboard
EndpointPOST https://www.getclearmargins.com/api/platform/health-score

Use a Scale API key in the Authorization header. Enterprise Scale packages can include custom limits and review terms.

Request

Health-score API

curl -X POST https://www.getclearmargins.com/api/platform/health-score \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "revenue": 24000,
    "cogs": 7400,
    "fulfillment": 2100,
    "adSpend": 7200,
    "cashBalance": 180000,
    "monthlyExpenses": 54000,
    "pipelineValue": 160000,
    "winRate": 31,
    "salesCycleDays": 36,
    "averageDailySales": 42,
    "inventoryOnHand": 820,
    "leadTimeDays": 14,
    "safetyBufferDays": 6
  }'

Response

Structured operating signals

healthScore

0-100 operating score across contribution margin, runway, inventory, and pipeline.

grade

A-D plain-English quality band for the current operating model.

metrics

Formatted contribution margin, blended ROAS, runway, reorder point, pipeline velocity, and net contribution.

triggers

Actionable financial alerts with severity, message, and recommendation.

Granular endpoints

Single-calculator APIs

Use lightweight endpoints when you only need one calculator's logic — no need to send the full health-score payload.

POST/api/platform/marginRecommended price, profit per sale, markup
Required: cogs  Optional: fulfillment, marketing, targetMargin
POST/api/platform/runwayRunway months, burn rate, cash-flow status
Required: cashBalance, monthlyExpenses  Optional: monthlyRevenue

Send a GET to any endpoint for sample input and output without authentication.

Embeds

Put calculator moments inside partner software.

Embed previews are designed for CRMs, inventory tools, agency dashboards, finance portals, and SaaS admin panels that need decision math without sending users to another spreadsheet.

CRMPipeline Velocity Predictor/embed/pipeline-velocity
InventoryReorder Point Predictor/embed/reorder-point
MarketingBreak-Even ROAS Calculator/embed/break-even-roas

Scale access

Need live data, API volume, Enterprise controls, or embedded calculators?

Tell us where you want to embed Clear Margins and we will prioritize the right access path.