# SEC API Documentation SEC API provides REST and MCP access to SEC filings, companies, ownership data, financial statements, filing search, market data, events, webhooks, and agent-ready intelligence workflows. Use this file as the entrypoint for coding agents and LLM tools. Prefer the OpenAPI spec and canonical docs links below over guessing endpoint paths or inventing SDK methods. ## Agent Instructions - Base API URL: `https://api.secapi.ai` - Docs URL: `https://docs.secapi.ai` - OpenAPI spec: `https://docs.secapi.ai/openapi/sec-api-public.v1.json` - MCP endpoint: `https://api.secapi.ai/mcp` - Authenticate REST calls with `x-api-key: $SECAPI_API_KEY`. - Pin examples with `secapi-version: 2026-03-19` when possible. - Preserve `requestId`, `traceparent`, `provenance`, `freshness`, `materialization`, accession numbers, and SEC source URLs in user-facing answers. - Do not remove degraded-state, partial-coverage, entitlement, or rate-limit metadata. - Do not assume market-data routes are available unless the customer has the required plan and provider entitlements. ## OpenAPI Specs - [SEC API OpenAPI JSON](https://docs.secapi.ai/openapi/sec-api-public.v1.json): Complete public REST contract for generated clients, playgrounds, and endpoint discovery. ## Start Here - [Overview](https://docs.secapi.ai): Start page for SEC API documentation. - [SEC API Docs](https://docs.secapi.ai/sec-api-docs): Workflow-oriented entrypoint for common investor and agent tasks. - [Getting started](https://docs.secapi.ai/getting-started): First API key, first request, and next steps. - [First request flows](https://docs.secapi.ai/first-request-flows): Copyable entity, filing, statements, and search requests. - [API playground](https://docs.secapi.ai/api-playground): Interactive and copyable examples for common endpoints. - [API conventions](https://docs.secapi.ai/api-conventions): Authentication, versioning, pagination, errors, metadata, and response formats. ## API Reference - [API reference](https://docs.secapi.ai/api-reference): Public REST endpoint families. - [Entities](https://docs.secapi.ai/api-reference/entities/get-v1-entities-resolve): Resolve tickers, CIKs, FIGIs, CUSIPs, ISINs, and names. - [Filings](https://docs.secapi.ai/api-reference/filings/get-v1-filings): Search and retrieve SEC filing metadata. - [Filing sections](https://docs.secapi.ai/api-reference/filings/get-v1-filings-accession-number-sections-section-key): Extract filing items and sections. - [Statements](https://docs.secapi.ai/api-reference/statements/get-v1-statements-all): Get normalized financial statements. - [Facts](https://docs.secapi.ai/api-reference/facts/get-v1-facts): Get normalized SEC company facts. - [Ownership](https://docs.secapi.ai/api-reference/owners/get-v1-owners-13f): Retrieve 13F, institutional, and beneficial ownership data. - [Insiders](https://docs.secapi.ai/api-reference/insiders/get-v1-insiders): Retrieve Forms 3, 4, and 5 insider trading records. - [Search](https://docs.secapi.ai/api-reference/search/get-v1-search-fulltext): Full-text and semantic filing search. - [Events](https://docs.secapi.ai/api-reference/platform/get-v1-events): Filing-derived and delivery events. - [Webhooks](https://docs.secapi.ai/api-reference/webhooks/get-v1-webhook-endpoints): Signed webhook endpoints, deliveries, replay, and rotation. - [Billing rates](https://docs.secapi.ai/api-reference/platform/get-v1-billing-rates): Public pricing catalog and meter rates. ## SDKs, MCP, And Agents - [Libraries and SDKs](https://docs.secapi.ai/libraries-and-sdks): Runtime options and package naming. - [JavaScript SDK](https://docs.secapi.ai/javascript-sdk): JavaScript and TypeScript examples. - [Python SDK](https://docs.secapi.ai/python-sdk): Python examples. - [Go SDK](https://docs.secapi.ai/go-sdk): Go examples. - [Rust SDK](https://docs.secapi.ai/rust-sdk): Rust examples. - [MCP workflows](https://docs.secapi.ai/mcp-workflows): Hosted MCP setup and usage. - [MCP install](https://docs.secapi.ai/mcp-install): MCP client setup. - [LLM and agent guide](https://docs.secapi.ai/llm-guide): Instructions for agents using SEC API docs and results. - [Give this prompt to your agent](https://docs.secapi.ai/give-this-prompt-to-your-agent): Copyable setup prompt for coding agents. ## Pricing, Trust, And Operations - [Plans and pricing](https://docs.secapi.ai/plans-and-pricing): Public plan table and meter classes. - [Pay as you go](https://docs.secapi.ai/pay-as-you-go): PAYG model and examples. - [Billing FAQ](https://docs.secapi.ai/billing-faq): Billing, limits, and plan behavior. - [Freshness and trust](https://docs.secapi.ai/freshness-and-trust): Freshness, provenance, and response evidence metadata. - [Coverage and depth](https://docs.secapi.ai/coverage-and-depth): Coverage status by workflow family. - [Status](https://docs.secapi.ai/status): Current production status. - [Changelog](https://docs.secapi.ai/changelog): Public release notes. - [Glossary](https://docs.secapi.ai/glossary): Common SEC API, EDGAR, filing, and agent terms. ## Common Workflows - [Build a filing monitor](https://docs.secapi.ai/tutorials/build-filing-monitor): Monitor filings and deliver alerts. - [Monitor 13F holdings](https://docs.secapi.ai/tutorials/monitor-13f-holdings): Track institutional ownership changes. - [Extract revenue from a 10-K](https://docs.secapi.ai/tutorials/extract-revenue-from-10k): Pull statements and filing evidence. - [Semantic search risk factors](https://docs.secapi.ai/tutorials/semantic-search-risk-factors): Search filing sections by concept. - [Compare executive compensation](https://docs.secapi.ai/tutorials/compare-executive-compensation): Retrieve and compare proxy compensation data. ## Migration Guides - [Migrate from sec-api.io](https://docs.secapi.ai/migrate-from-sec-api) - [Migrate from Financial Datasets](https://docs.secapi.ai/migrate-from-financialdatasets-ai) - [Migrate from AskEdgar](https://docs.secapi.ai/migrate-from-askedgar) - [Migrate from FactorsToday](https://docs.secapi.ai/migrate-from-factorstoday) - [Migrate from Trading Economics](https://docs.secapi.ai/migrate-from-trading-economics)