Economic model

GET/api/company/economic-model

🔒 Audit-grade by construction

Every claim in this response is defensible in an IC meeting or audit. Most competing "AI fundamentals" APIs return plausible-sounding prose you cannot verify. This endpoint is different. For each claim you get:

🔗 a clickable URL to the exact authoritative document (SEC EDGAR 10-K / 10-Q / 8-K),
📄 the document section the claim is drawn from (e.g., Item 7 MD&A, Note 3 — Revenue),
💬 a verbatim quote from that section (20–400 characters, copied word-for-word),
✅ machine-verified at generation time — we fetch the filing, strip HTML, and confirm the quote literally appears in the document before we store it. Fabricated or paraphrased quotes are rejected and the model is regenerated.

An analyst can click a URL, jump to the section, Ctrl-F the quote, and have the source paragraph in front of them in ten seconds. No more "trust me, the AI read the filing."

What's in the model

Offerings, value delivery, monetization, cost structure, reinvestment, cash conversion, sensitivities, unit economics, capital allocation, management style, operating levers, strategic initiatives, structural advantages, flywheels, and failure modes.

Every section and array item carries a sources array of machine-verified citations.

Two possible response shapes

✅ `200 OK` — model is ready

Returns the full EconomicModel JSON. Stable and safe to cache client-side.

⏳ `202 Accepted` — model is being generated

The model for this company has never been built. A background job has been queued (or one was already in flight).

Generation takes a few minutes. The job fetches the company's latest 10-K, 10-Q, and 8-Ks directly from SEC EDGAR, passes them to the AI along with strict citation requirements, verifies every quote against the filing text, and writes the result.

Poll this same endpoint with the same symbol — once the job completes you will start receiving the 200 response. A reasonable poll interval is every 30 seconds.

{
  "status": "generating",
  "jobId": "64abfe1234567890abcdef12",
  "message": "Generating economic model — this can take a few minutes. Call this endpoint again to retrieve the result."
}

Deduplication

If a generation job is already in flight for this company — regardless of which account queued it — this endpoint returns the existing jobId. You will never queue two generations for the same company.

Cost

Generation runs server-side and does not count against your API request budget beyond the call to this endpoint.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/company/economic-model?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Model is ready. Full economic model JSON with per-claim SEC-filing citations.

Response schema

summary object
High-level inventory of what the company sells.
- primaryOfferings array of string
- secondaryOfferings array of string
valueDelivery object
How the company creates value and who pays for it.
- offeringTypes array of string
- customer object
  - primaryPayerTypes array of string
  - demandDriver string
- unitOfValue string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
monetization object
Revenue model, pricing mechanisms, pricing power, and revenue drivers.
- revenueModel string
  one-time | recurring | hybrid
- pricingMechanisms array of string
- priceSettingPower string
  price-taker | some | strong | regulated | unknown
- primaryRevenueDrivers array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
costStructure object
Variable and fixed cost drivers, margin mechanics, primary constraint.
- variableCostDrivers array of string
- fixedCostDrivers array of string
- marginDriverMechanisms array of string
- primaryConstraint string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
reinvestment object
Capital intensity and reinvestment orientation.
- capitalIntensity string
  asset-light | moderate | asset-heavy | regulated-asset-base | unknown
- reinvestmentVehicles array of string
- maintenanceVsGrowth string
  mostly-maintenance | balanced | mostly-growth | unknown
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
cashConversion object
Working-capital profile and cash-flow timing.
- workingCapitalProfile string
  negative | neutral | positive | seasonal | unknown
- cashTimingNotes string
- keyBalanceSheetSensitivities array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
sensitivities object
What moves top line, margin, and balance sheet.
- topLineSensitivities array of string
- marginSensitivities array of string
- balanceSheetSensitivities array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
unitEconomics object
Per-unit revenue drivers, variable costs, and marginal margin.
- unit string
- revenueDrivers array of string
- variableCosts array of string
- marginalMargin string
  low | mid | high
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
capitalAllocation object
Capital-allocation priorities, historical pattern, and metrics to watch.
- priorities array of string
- historicalPattern string
- watchMetrics array of string | null
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
managementStyle object
Management orientation and strategy notes.
- orientation string
  growth-first | margin-first | balanced | capital-return
- strategyNotes string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
provenance object
Whole-model confidence and a deduped list of the source kinds cited across the model.
- confidence string
  low | medium | high
- sources array of string
offerings array of object
Structured list of each product or service with monetization, economics notes, KPIs, and citations.
array of:
- name string
- type string
  product | service | platform | bundle
- category string | null
- targetCustomer string | null
- revenueRole string
  core | growth | adjacent | legacy | other
- monetization object | null
  model string
  pricingUnit string | null
- economicsNotes object | null
  marginProfile string | null
  keyCostDrivers array of string | null
  keyGrowthDrivers array of string | null
- kpiMappings object | null
  primaryMetrics array of string | null
  supportingMetrics array of string | null
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
operatingLevers array of object
Named operating levers with directionality (↑ lever → ↑ revenue, etc.) and the metrics they map to.
array of:
- lever string
- directionality string
- mapsToMetrics array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
strategicInitiatives array of object
Named initiatives with stage, expected impact, time horizon, affected levers, metrics to watch, and citations.
array of:
- initiative string
- category string
- rationale string
- financialImpact string
- stage string
  announced | early | scaling | mature
- impactLevel string
  minor | moderate | major
- timeHorizon string
  short | medium | long
- affectsLevers array of string | null
- watchMetrics array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
structuralAdvantages array of object
Moat elements with type, mechanism, persistence, affected levers, and citations.
array of:
- advantage string
- type string
  network-effect | switching-cost | scale-economy | data-advantage | brand | regulatory-moat | distribution | ip-patents | other
- mechanism string
- persistence string
  weak | moderate | strong
- affectsLevers array of string
- watchMetrics array of string
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
flywheels array of object
Causal loops (growth / margin / defensibility) with ordered steps and citations.
array of:
- name string
- loop array of string
- impact string
  growth | margin | defensibility
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.
failureModes array of object
Risks that could break the business model, with mechanism, metrics to watch, and citations.
array of:
- risk string
- mechanism string
- watchMetrics array of string | null
- sources array of object
  array of:
  url string (uri)
  HTTPS URL to the cited document (SEC EDGAR 10-K / 10-Q / 8-K / 20-F / 40-F / 6-K, investor presentation, earnings call, or website)
  source string (enum)
  Document kind. Foreign private issuers file 20-F/40-F annual reports and 6-K interim reports instead of 10-K/10-Q/8-K.
  Allowed values: 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, investor-presentation, earnings-call, website
  publisher string
  URL host, derived server-side (e.g., `www.sec.gov`).
  section string
  Named location within the document (e.g., `Item 7 MD&A`, `Note 3 — Revenue`, `Recent Developments`).
  quote string
  Verbatim excerpt (20–400 characters) copied word-for-word from the cited section. Machine-verified at generation time.
  validated boolean
  Present and `false` only when the URL could not be re-fetched at verification time (e.g., 403/429/timeout). Absent ≡ fully verified.

Example response

{
  "summary": {
    "primaryOfferings": [
      "string"
    ],
    "secondaryOfferings": [
      "string"
    ]
  },
  "valueDelivery": {
    "offeringTypes": [
      "string"
    ],
    "customer": {
      "primaryPayerTypes": [
        "string"
      ],
      "demandDriver": "string"
    },
    "unitOfValue": "string",
    "sources": [
      {}
    ]
  },
  "monetization": {
    "revenueModel": "string",
    "pricingMechanisms": [
      "string"
    ],
    "priceSettingPower": "string",
    "primaryRevenueDrivers": [
      "string"
    ],
    "sources": [
      {}
    ]
  },
  "costStructure": {
    "variableCostDrivers": [
      "string"
    ],
    "fixedCostDrivers": [
      "string"
    ],
    "marginDriverMechanisms": [
      "string"
    ],
    "primaryConstraint": "string",
    "sources": [
      {}
    ]
  },
  "reinvestment": {
    "capitalIntensity": "string",
    "reinvestmentVehicles": [
      "string"
    ],
    "maintenanceVsGrowth": "string",
    "sources": [
      {}
    ]
  },
  "cashConversion": {
    "workingCapitalProfile": "string",
    "cashTimingNotes": "string",
    "keyBalanceSheetSensitivities": [
      "string"
    ],
    "sources": [
      {}
    ]
  },
  "sensitivities": {
    "topLineSensitivities": [
      "string"
    ],
    "marginSensitivities": [
      "string"
    ],
    "balanceSheetSensitivities": [
      "string"
    ],
    "sources": [
      {}
    ]
  },
  "unitEconomics": {
    "unit": "string",
    "revenueDrivers": [
      "string"
    ],
    "variableCosts": [
      "string"
    ],
    "marginalMargin": "string",
    "sources": [
      {}
    ]
  },
  "capitalAllocation": {
    "priorities": [
      "string"
    ],
    "historicalPattern": "string",
    "watchMetrics": [
      "string"
    ],
    "sources": [
      {}
    ]
  },
  "managementStyle": {
    "orientation": "string",
    "strategyNotes": "string",
    "sources": [
      {}
    ]
  },
  "provenance": {
    "confidence": "string",
    "sources": [
      "string"
    ]
  },
  "offerings": [
    {
      "name": "string",
      "type": "string",
      "category": "string",
      "targetCustomer": "string",
      "revenueRole": "string",
      "monetization": {
        "model": "string",
        "pricingUnit": "string"
      },
      "economicsNotes": {
        "marginProfile": "string",
        "keyCostDrivers": [
          "string"
        ],
        "keyGrowthDrivers": [
          "string"
        ]
      },
      "kpiMappings": {
        "primaryMetrics": [
          "string"
        ],
        "supportingMetrics": [
          "string"
        ]
      },
      "sources": [
        {}
      ]
    }
  ],
  "operatingLevers": [
    {
      "lever": "string",
      "directionality": "string",
      "mapsToMetrics": [
        "string"
      ],
      "sources": [
        {}
      ]
    }
  ],
  "strategicInitiatives": [
    {
      "initiative": "string",
      "category": "string",
      "rationale": "string",
      "financialImpact": "string",
      "stage": "string",
      "impactLevel": "string",
      "timeHorizon": "string",
      "affectsLevers": [
        "string"
      ],
      "watchMetrics": [
        "string"
      ],
      "sources": [
        {}
      ]
    }
  ],
  "structuralAdvantages": [
    {
      "advantage": "string",
      "type": "string",
      "mechanism": "string",
      "persistence": "string",
      "affectsLevers": [
        "string"
      ],
      "watchMetrics": [
        "string"
      ],
      "sources": [
        {}
      ]
    }
  ],
  "flywheels": [
    {
      "name": "string",
      "loop": [
        "string"
      ],
      "impact": "string",
      "sources": [
        {}
      ]
    }
  ],
  "failureModes": [
    {
      "risk": "string",
      "mechanism": "string",
      "watchMetrics": [
        "string"
      ],
      "sources": [
        {}
      ]
    }
  ]
}

202 Accepted

Model generation has been queued (or one is already in flight). Poll the same URL for the finished result.

Response schema

status string (enum)
Allowed values: generating
jobId string
ID of the background job
message string

Example response

{
  "status": "generating",
  "jobId": "64abfe1234567890abcdef12",
  "message": "Generating economic model — this can take a few minutes. Call this endpoint again to retrieve the result."
}

400 Bad Request

Invalid parameters, company not found, or the symbol is not a stock (funds use `/api/fund/exposure-model`)

Response schema

error string
Human-readable error message

Example response

{}

401 Unauthorized

Missing or invalid API token

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}

Economic model

🔒 Audit-grade by construction

What's in the model

Two possible response shapes

✅ 200 OK — model is ready

⏳ 202 Accepted — model is being generated

Deduplication

Cost

Query parameters

Example request

Responses

200 OK

Response schema

Example response

202 Accepted

Response schema

Example response

400 Bad Request

Response schema

Example response

401 Unauthorized

Response schema

Example response

403 Forbidden

Response schema

Example response

✅ `200 OK` — model is ready

⏳ `202 Accepted` — model is being generated