# stockinsights.ai APIs ## Docs - [Introduction](https://docs.stockinsights.ai/introduction.md): stockinsights.ai, a Generative-AI enabled investment research platform - [Getting Started](https://docs.stockinsights.ai/getting-started.md): Learn how you can use stockinsighs.ai in your investment journey - [AI Assist](https://docs.stockinsights.ai/features/ai-assist.md): Your Intelligent Filing Research Companion - [Search Filings](https://docs.stockinsights.ai/features/filings-search.md): Efficiently Find Key Financial Information - [AI Generated Summaries](https://docs.stockinsights.ai/features/filings-ai-insights.md): Effortless Insights from Earnings Calls and Annual Reports - [Announcements Tracker](https://docs.stockinsights.ai/features/announcements-tracker.md): Stay Updated on Company Updates with Smart Classifications - [Email Notifications](https://docs.stockinsights.ai/features/email-alerts.md): Stay Informed with Email Alerts - [Embeddable AI Agent](https://docs.stockinsights.ai/solutions/ai_agent.md): A New Way to Power Seamless, On-Demand Insights - [Automated Company Screening](https://docs.stockinsights.ai/solutions/screener.md): Screen Key Disclosures and Discover Investment Opportunities with Our Screener - [Custom Prompts for Notifications](https://docs.stockinsights.ai/solutions/custom-alerts.md): Personalize Your Notifications from Filings with Custom Prompts - [Authentication](https://docs.stockinsights.ai/api-reference/authentication.md): How to authenticate requests to the API. - [Companies List](https://docs.stockinsights.ai/api-reference/india_endpoints/companies.md): Returns a paginated list of India-listed companies with identifiers (ISIN, BSE, NSE) and industry classification. Supports filtering by ticker, sector, industry, market-cap category, and company ID. Defaults to sort by `company_name` ascending. - [Filings Feed](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-feed.md): The Filings Feed API retrieves real-time updates on earnings call transcripts and other corporate filings (e.g., Annual Reports, Investor Presentations, Corporate Announcements) published on the BSE/NSE exchanges based on the specified document type. Users can optionally filter results by sector, ti… - [Filings Keyword Search](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-keywords-search.md): The Filings Keyword Search API fetches search results from our database for specified filings (earnings transcripts and annual reports) for any given keyword/phrase. Returns upto 100 search results sorted by latest date - [Filings Embeddings Search](https://docs.stockinsights.ai/api-reference/india_endpoints/filings-embeddings-search.md): The Filings Embeddings Search API retrieves the nearest chunks of text (based on semantic similarity) from our database for specified filings (earnings transcripts and annual reports) for any given user query/prompt in natural langauge. Users can utilize this functionality for various purposes, such… - [Announcements Tagged Feed](https://docs.stockinsights.ai/api-reference/india_endpoints/announcements-tagged-feed.md): The Announcements Tagged Feed API delivers a real-time stream of Corporate filings disclosed to BSE/NSE exchanges, each tagged with AI-generated insights including summaries, category tags (drawn from a predefined set of categories), and sentiment tags. Users can utilize this tagged feed to monitor… - [Results Calendar API](https://docs.stockinsights.ai/api-reference/india_endpoints/results-calendar.md): Returns the latest paginated results calendar for listed Indian companies, optionally filtered by ticker. - [Income Statement](https://docs.stockinsights.ai/api-reference/india_endpoints/income-statement.md): Retrieve a structured income statement (profit & loss) for an Indian company. By default, this returns the latest consolidated quarterly result. Supply optional period, reporting type, or scope parameters for a different statement. The financials structure is selected by the returned profile: bank,… - [Balance Sheet](https://docs.stockinsights.ai/api-reference/india_endpoints/balance-sheet.md): Retrieve a structured balance sheet for an Indian company. By default, this returns the latest consolidated balance sheet from a half-yearly filing. Balance-sheet facts remain point-in-time (`reporting_type: as_of`); the optional `reporting_type` query parameter selects the source filing cadence. Th… - [Cash Flow Statement](https://docs.stockinsights.ai/api-reference/india_endpoints/cash-flow.md): Retrieve a structured cash flow statement for an Indian company. By default, this returns the latest consolidated half-yearly result. Supply optional period, reporting type, or scope parameters for a different statement. The financials structure is selected by the returned profile: bank, nonbank, li… - [Segment Results](https://docs.stockinsights.ai/api-reference/india_endpoints/segment-results.md): See how each of a company’s businesses contributes to revenue and profit. By default, this returns the latest consolidated quarterly result. Some filings also report assets, liabilities, and capital employed by business. - [Shareholding Pattern History](https://docs.stockinsights.ai/api-reference/india_endpoints/shareholding-pattern.md): Retrieve canonical shareholding patterns for an Indian company. By default, the response contains the latest eight periodic observations, newest first. Use filing_basis to select pre-listing or capital-restructuring filings, and as_of_date to select an exact observation date. Headline percentages an… - [Shareholding Pattern Holders](https://docs.stockinsights.ai/api-reference/india_endpoints/shareholding-holders.md): Drill into disclosed holder rows from one canonical shareholding filing. By default, the latest periodic snapshot is selected. Use filing_basis to select a different filing type and as_of_date to select an exact observation. Category and holder-name filters are applied after selecting the snapshot a… - [Companies List](https://docs.stockinsights.ai/api-reference/us_endpoints/companies.md): Returns a paginated list of US-listed companies with identifiers (CIK, ticker), exchange information, and industry classification. Supports filtering by ticker, CIK, sector, industry, market-cap category, and company ID. Defaults to sort by `company_name` ascending. - [Filings Feed](https://docs.stockinsights.ai/api-reference/us_endpoints/filings-feed.md): The Filings Feed API retrieves real-time updates on earnings call transcripts and SEC filings (e.g., 10-K, 10-Q, 8-K) based on the specified document type. Users can optionally filter results by sector, timeframe, or other parameters to facilitate targeted information retrieval. - [Filings Embeddings Search](https://docs.stockinsights.ai/api-reference/us_endpoints/filings-embeddings-search.md): The Filings Embeddings Search API retrieves the nearest chunks of text (based on semantic similarity) from our database for specified filings (earnings transcripts and 10-Ks) for any given user query/prompt in natural langauge. Users can utilize this functionality for various purposes, such as build… - [8-K/6-K Tagged Feed](https://docs.stockinsights.ai/api-reference/us_endpoints/8k-6k-tagged-feed.md): The API returns the latest 8-K and 6-K feed from SEC Edgar, each tagged with AI-generated insights including summaries, category tags (drawn from a predefined set of categories), and sentiment tags. Users can utilize this tagged feed to monitor daily updates on material events reported by companies,… - [Income Statement](https://docs.stockinsights.ai/api-reference/us_endpoints/income-statement.md): Retrieve an as-reported income statement for a US issuer by SEC CIK, period end date, and reporting type. Resolves across 10-Q, 10-K, and 20-F filings (including amendments), preferring the original filing that first reported the period. - [Balance Sheet](https://docs.stockinsights.ai/api-reference/us_endpoints/balance-sheet.md): Retrieve an as-reported balance sheet for a US issuer by SEC CIK and period end date. Resolves across 10-Q, 10-K, and 20-F filings (including amendments), preferring the original filing that first reported the period. Balance sheets are point-in-time snapshots; reporting_type in the response is alwa… - [Cash Flow Statement](https://docs.stockinsights.ai/api-reference/us_endpoints/cash-flow.md): Retrieve an as-reported cash flow statement for a US issuer by SEC CIK, period end date, and reporting type. Resolves across 10-Q, 10-K, and 20-F filings (including amendments), preferring the original filing that first reported the period. - [Contextual Search](https://docs.stockinsights.ai/api-reference/sample_scripts/contextual-search.md): How to use Embeddings API for performing Contextual Search. - [Question Answering](https://docs.stockinsights.ai/api-reference/sample_scripts/question-answering.md): How to use Embeddings API for Natural Language Question Answering via any LLM - [MCP & Plugins Overview](https://docs.stockinsights.ai/plugins/overview.md): Integrate stockinsights.ai directly into your favorite AI assistants, chat interfaces, and IDEs using our Model Context Protocol (MCP) servers. - [Claude Cowork Setup](https://docs.stockinsights.ai/plugins/claude-cowork.md): Learn how to install and connect the stockinsights-in plugin on the Claude Cowork app to fetch Indian market data. - [Webhooks Overview](https://docs.stockinsights.ai/webhooks/overview.md): Receive filing events from StockInsights in real time, instead of polling the API. - [Events & Payloads](https://docs.stockinsights.ai/webhooks/events.md): The events you can subscribe to and the JSON payload StockInsights sends. - [Verifying Signatures](https://docs.stockinsights.ai/webhooks/verifying-signatures.md): Confirm each webhook came from StockInsights and was not modified in transit. - [Delivery & Retries](https://docs.stockinsights.ai/webhooks/delivery-and-retries.md): How StockInsights delivers webhooks, which failures are retried, and on what schedule. ## OpenAPI Specs - [openapi-india](https://docs.stockinsights.ai/api-reference/openapi-india.json) - [openapi-us](https://docs.stockinsights.ai/api-reference/openapi-us.json) ## Optional - [Blog](https://stockinsights.ai/blog)