# Fiscal.ai API Documentation

> Fiscal.ai provides a financial data API delivering institutional-quality as-reported and standardized financials, ratios, stock prices, segments & KPIs, adjusted metrics, and filing sourcing for public companies in the US, Canada, UK, and EU.

This is the documentation site for the Fiscal.ai REST API. It covers authentication, endpoint usage, company querying, rate limits, and interactive endpoint references with example responses. Every page link below is the page's Markdown; append `.md` to any docs URL for the same.

## Agent Resources

- [Fiscal.ai API skill](https://docs.fiscal.ai/skill.md): How to call the API — auth, company identifiers, which endpoint to use, periods, pagination, errors. Install with `npx skills add https://docs.fiscal.ai`
- [All docs in one file](https://docs.fiscal.ai/llms-full.txt): Every page below, concatenated
- [Authentication](https://docs.fiscal.ai/docs/authentication.md): Send your Fiscal.ai API key in the X-Api-Key header on every request.
- [OpenAPI Spec](https://api.fiscal.ai/openapi.json): Machine-readable OpenAPI 3.1 specification
- MCP server: `https://api.fiscal.ai/mcp` (Streamable HTTP; OAuth or `Authorization: Bearer <API key>`) — see [MCP / Connectors](https://docs.fiscal.ai/docs/guides/mcp-integration.md)

## Guides

- [API Changelog](https://docs.fiscal.ai/docs/guides/api-changelog.md)
- [Getting Started](https://docs.fiscal.ai/docs/guides/getting-started.md): Get your API key and make your first request in under 5 minutes. Start pulling clean financial data from the Fiscal.ai API today.
- [Free Trial](https://docs.fiscal.ai/docs/guides/free-trial.md): Try the Fiscal.ai API free — access institutional-quality data for 100 companies with 250 calls/day. No credit card required.
- [Companies List & Profile](https://docs.fiscal.ai/docs/guides/companies-list.md): The complete guide to the Companies List and Company Profile endpoints — coverage, stable identifiers, listings, peers, every field, and how to page through the universe.
- [Company Querying](https://docs.fiscal.ai/docs/guides/company-querying.md): Query companies by ticker, exchange, company key, Fiscal Identifier (fscl), CUSIP, ISIN, or FIGI. Flexible lookup methods for seamless integration.
- [MCP / Connectors](https://docs.fiscal.ai/docs/guides/mcp-integration.md): Power AI assistants with real-time financial data. Connect Claude, ChatGPT, or any MCP client to the Fiscal.ai API in minutes.
- [MCP Skills](https://docs.fiscal.ai/docs/guides/mcp-skills.md): A skill is an out-of-the-box prompt that harnesses the power of the Fiscal MCP for your research. Each teaches your AI agent how to run a specific analyst task on source-linked Fiscal.ai data.
- [Fund Letters](https://docs.fiscal.ai/docs/guides/fund-letters.md): The complete guide to the Fund Letters endpoints — investor letters, extracted company theses, permanent identifiers, coverage, and how the corpus is curated.
- [Webhooks](https://docs.fiscal.ai/docs/guides/webhooks.md): Get real-time notifications the moment financial data updates. Webhooks deliver clean fundamentals to your app within minutes of disclosure.
- [Rate Limits & Errors](https://docs.fiscal.ai/docs/guides/rate-limits.md): Rate limits, error codes, and HTTP status responses for the Fiscal.ai API. Understand usage tiers and troubleshoot integration issues.

## Migrations

- [Companies List & Profile (v2 → v3)](https://docs.fiscal.ai/docs/migrations/companies-list-v2-to-v3.md): How to migrate the Companies List and Company Profile endpoints from v2 to v3 — why coverage expanded from ~12,000 to ~55,000 companies with secondary listings, and every field, rename, and behavior change you need to make the switch.

## Reference

- [Adjusted Metrics](https://docs.fiscal.ai/docs/reference/adjusted.md): Adjusted EPS, revenue, EBITDA, FCF, and more — the full list of adjusted metrics for matching analyst estimates and consensus data.
- [Agentic Consensus](https://docs.fiscal.ai/docs/reference/estimates.md): How the estimates response is built: reported and forecast periods, GAAP and adjusted lines, omitted lines, withheld values and flags.
- [Ratios](https://docs.fiscal.ai/docs/reference/ratios.md): Full list of daily financial ratios — valuation, profitability, leverage, and efficiency metrics with 30+ years of history.

## API Reference

- [Full API Reference](https://docs.fiscal.ai/docs/api-reference.md): Every endpoint with its parameters and response fields
- [Swagger UI](https://api.fiscal.ai/docs): Interactive Swagger documentation

### Endpoints

- [Company — Companies List](https://docs.fiscal.ai/docs/api-reference.md#companies-list): GET endpoint (v3)
- [Company — Company Profile](https://docs.fiscal.ai/docs/api-reference.md#company-profile): GET endpoint (v3)
- [Financials As Reported — Income Statement](https://docs.fiscal.ai/docs/api-reference.md#financials-as-reported-income-statement): GET endpoint (v1)
- [Financials As Reported — Balance Sheet](https://docs.fiscal.ai/docs/api-reference.md#financials-as-reported-balance-sheet): GET endpoint (v1)
- [Financials As Reported — Cash Flow Statement](https://docs.fiscal.ai/docs/api-reference.md#financials-as-reported-cash-flow-statement): GET endpoint (v1)
- [Financials Standardized — Income Statement](https://docs.fiscal.ai/docs/api-reference.md#financials-standardized-income-statement): GET endpoint (v1)
- [Financials Standardized — Balance Sheet](https://docs.fiscal.ai/docs/api-reference.md#financials-standardized-balance-sheet): GET endpoint (v1)
- [Financials Standardized — Cash Flow Statement](https://docs.fiscal.ai/docs/api-reference.md#financials-standardized-cash-flow-statement): GET endpoint (v1)
- [Financials Standardized — Standardized Metrics List](https://docs.fiscal.ai/docs/api-reference.md#standardized-metrics-list): GET endpoint (v1)
- [Financials Standardized — All Standardized Metrics](https://docs.fiscal.ai/docs/api-reference.md#all-standardized-metrics): GET endpoint (v1)
- [Company Ratios — Company Ratios](https://docs.fiscal.ai/docs/api-reference.md#company-ratios): GET endpoint (v1)
- [Company Ratios — Daily Ratios](https://docs.fiscal.ai/docs/api-reference.md#daily-ratios): GET endpoint (v1)
- [Company Ratios — Ratios List](https://docs.fiscal.ai/docs/api-reference.md#ratios-list): GET endpoint (v1)
- [Company Ratios — Shares Outstanding](https://docs.fiscal.ai/docs/api-reference.md#shares-outstanding): GET endpoint (v1)
- [Adjusted Metrics — Adjusted Metrics](https://docs.fiscal.ai/docs/api-reference.md#adjusted-metrics): GET endpoint (v1)
- [Estimates — Agentic Consensus](https://docs.fiscal.ai/docs/api-reference.md#agentic-consensus): GET endpoint (v1)
- [Estimates — Street Consensus](https://docs.fiscal.ai/docs/api-reference.md#street-consensus): GET endpoint (v1)
- [Estimates — Analyst Ratings](https://docs.fiscal.ai/docs/api-reference.md#analyst-ratings): GET endpoint (v1)
- [Segments and KPIs — Segments and KPIs (v2)](https://docs.fiscal.ai/docs/api-reference.md#segments-and-kpis-v2): GET endpoint (v2)
- [Ownership — Insider Holders](https://docs.fiscal.ai/docs/api-reference.md#insider-holders): GET endpoint (v1)
- [Ownership — Insider Transactions](https://docs.fiscal.ai/docs/api-reference.md#insider-transactions): GET endpoint (v1)
- [Ownership — Institutional Holders (Company)](https://docs.fiscal.ai/docs/api-reference.md#institutional-holders-company): GET endpoint (v1)
- [Ownership — Institutional Holdings (Holder)](https://docs.fiscal.ai/docs/api-reference.md#institutional-holdings-holder): GET endpoint (v1)
- [Ownership — Institutional Holders List](https://docs.fiscal.ai/docs/api-reference.md#institutional-holders-list): GET endpoint (v1)
- [Events Calendar — Events Calendar](https://docs.fiscal.ai/docs/api-reference.md#events-calendar): GET endpoint (v1)
- [Corporate Actions — Stock Splits](https://docs.fiscal.ai/docs/api-reference.md#stock-splits): GET endpoint (v1)
- [Corporate Actions — Dividends](https://docs.fiscal.ai/docs/api-reference.md#dividends): GET endpoint (v1)
- [Stock Prices — Stock Prices](https://docs.fiscal.ai/docs/api-reference.md#stock-prices): GET endpoint (v3)
- [Stock Prices — Intraday Stock Prices](https://docs.fiscal.ai/docs/api-reference.md#intraday-stock-prices): GET endpoint (v1)
- [Company Filings — Company Filings](https://docs.fiscal.ai/docs/api-reference.md#company-filings-v2): GET endpoint (v2)
- [Financials Sourcing — Filing Image (by page)](https://docs.fiscal.ai/docs/api-reference.md#filing-image-by-page): GET endpoint (v1)
- [Financials Sourcing — Filing PDF](https://docs.fiscal.ai/docs/api-reference.md#filing-pdf): GET endpoint (v1)
- [Investor Relations — IR Events](https://docs.fiscal.ai/docs/api-reference.md#investor-relations): GET endpoint (v1)
- [Investor Relations — Event Transcript](https://docs.fiscal.ai/docs/api-reference.md#event-transcript): GET endpoint (v1)
- [Investor Relations — Event Audio](https://docs.fiscal.ai/docs/api-reference.md#event-audio): GET endpoint (v1)
- [Logo — Company Logo](https://docs.fiscal.ai/docs/api-reference.md#company-logo): GET endpoint (v2)
- [News — Company News](https://docs.fiscal.ai/docs/api-reference.md#company-news): GET endpoint (v1)
- [News — Company News Summary](https://docs.fiscal.ai/docs/api-reference.md#company-news-summary): GET endpoint (v1)
- [News — Top News](https://docs.fiscal.ai/docs/api-reference.md#top-news): GET endpoint (v1)
- [Fund Letters — Fund Letters](https://docs.fiscal.ai/docs/api-reference.md#fund-letters): GET endpoint (v1)
- [Fund Letters — Fund Letter Detail](https://docs.fiscal.ai/docs/api-reference.md#fund-letter-detail): GET endpoint (v1)
- [Fund Letters — Fund Letter PDF](https://docs.fiscal.ai/docs/api-reference.md#fund-letter-pdf): GET endpoint (v1)
- [Fund Letters — Fund Letter Investors](https://docs.fiscal.ai/docs/api-reference.md#fund-letter-investors): GET endpoint (v1)
- [Fund Letters — Fund Letter Investor Detail](https://docs.fiscal.ai/docs/api-reference.md#fund-letter-investor-detail): GET endpoint (v1)
- [Fund Letters — Fund Letter Companies](https://docs.fiscal.ai/docs/api-reference.md#fund-letter-companies): GET endpoint (v1)
- [Fund Letters — Company Fund Letters](https://docs.fiscal.ai/docs/api-reference.md#company-fund-letters): GET endpoint (v1)
- [Funds & ETFs — Funds List](https://docs.fiscal.ai/docs/api-reference.md#funds-list): GET endpoint (v1)
- [Funds & ETFs — Fund Profile](https://docs.fiscal.ai/docs/api-reference.md#fund-profile): GET endpoint (v1)
- [Funds & ETFs — Fund Performance](https://docs.fiscal.ai/docs/api-reference.md#fund-performance): GET endpoint (v1)
- [Funds & ETFs — Fund Distributions](https://docs.fiscal.ai/docs/api-reference.md#fund-distributions): GET endpoint (v1)
- [Funds & ETFs — Fund Holdings](https://docs.fiscal.ai/docs/api-reference.md#fund-holdings): GET endpoint (v1)
- [Funds & ETFs — Fund Prices](https://docs.fiscal.ai/docs/api-reference.md#fund-prices): GET endpoint (v1)
- [Funds & ETFs — Fund Intraday Prices](https://docs.fiscal.ai/docs/api-reference.md#fund-intraday-prices): GET endpoint (v1)

## Optional

- [Introduction](https://docs.fiscal.ai/docs/introduction.md): Institutional-quality financial data on tap. Integrate clean fundamentals, KPIs, ratios, and filings trusted by leading fintechs and asset managers.