Corporate AI Readiness Report API
AI Readiness Report answers the question a public company must now ask: do the AI systems that mediate investment research understand this filing correctly? It composes legibility, an institutional simulation, and the graph into a board-ready report.
What it returns
The response returns a verdict (AI_READY, IMPROVE_BEFORE_FILING, or HIGH_MISREAD_RISK), an overall_readiness score, a dimensions map across institutional, retail, developer, and regulatory readiness plus explainability, evidence coverage, contradiction clarity, structural clarity, and knowledge freshness, a legibility summary, an institutional_simulation (consensus, agreement, personas, blind spots, and any live frontier-model divergence), predicted_questions, recommendations, the trust envelope, and an issuer-facing compliance status.
Every report records its verdict to the Trust Ledger and feeds the predicted questions into the flywheel.
When to use it
Use this pre-file for the full board-ready view rather than the raw legibility primitive. Send the draft text and optionally a symbol to fold in graph freshness (recent filings on record).
The per-tier readiness comes from the simulator's persona panel, and recommendations map directly to the highest-risk flagged spans with an example each.
Notes and honesty
This analyzes the clarity, consistency, completeness, and machine-readability of public disclosure text via transparent analysis. It does not claim to optimize rankings inside proprietary models, nor predict or guarantee how any specific named model will respond. Deterministic and offline-safe; live frontier models can join the simulation under the same contract when configured. Not investment advice.
- verdict: AI_READY, IMPROVE_BEFORE_FILING, or HIGH_MISREAD_RISK
- dimensions: nine readiness sub-scores
- institutional_simulation: consensus, agreement, personas, blind spots
- predicted_questions the filing will trigger
- recommendations: issue, improve, and example per span
- ledger_id: the recorded composite verdict
curl -s https://api.lyramindos.com/v1/ai-readiness/report -H 'Content-Type: application/json' -H 'x-api-key: YOUR_KEY' -d '{"text":"The company expects results to remain broadly in line, subject to various factors.","symbol":"ACME"}'Questions
Does the report predict how Claude or GPT will respond?
No. It transparently analyzes the clarity and machine-readability of public text. It never predicts or guarantees how any specific named model will respond, and it is not investment advice.
Where do the readiness dimensions come from?
Per-tier readiness comes from the institutional simulator's persona panel, other dimensions from the legibility factors, and knowledge freshness from whether the graph has recent filings on record.
Does it record anything?
Yes. Each report records its composite verdict to the Trust Ledger and feeds its predicted questions into the question flywheel, which powers benchmarking and monitoring.