> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Browse the SEC API by family — entities, filings, statements, ownership, market, and platform — with a copyable prompt and example request on every operati…

<Info>
  Use the exact call you need. The page title in the sidebar matches the literal REST operation so coding agents and engineers can deep-link directly to the right contract.
</Info>

<Card title="Explore SEC API products" icon="boxes" href="https://secapi.ai/apis">Compare the marketing API catalog, workflow pages, glossary, and sandbox before choosing the endpoint family for a commercial or agentic workflow.</Card>

## Start here

<Steps>
  <Step title="Pick the domain you care about">Start from the family page that matches your workflow: entities, filings, statements, ownership, market utilities, or platform surfaces.</Step>
  <Step title="Open the exact operation page">Each operation page is titled with the literal REST call, such as `GET /v1/entities/resolve`.</Step>
  <Step title="Hand it to your agent">Every operation page includes a copyable prompt, example request, example response, metadata expectations, and failure posture.</Step>
</Steps>

## Common tasks

<CardGroup cols={2}>
  <Card title="Find the latest 10-K" icon="file-text" href="/api-reference/filings/get-v1-filings-latest">Use `GET /v1/filings/latest` with `ticker=AAPL&form=10-K` when you need the current annual report manifest.</Card>
  <Card title="Extract Item 1A risk factors" icon="braces" href="/api-reference/filings/get-v1-filings-latest-sections-section-key">Use `GET /v1/filings/latest/sections/{section_key}` with `section_key=item_1a` to fetch the latest 10-K risk-factor text.</Card>
  <Card title="Look up XBRL facts by tag" icon="table-properties" href="/api-reference/facts/get-v1-facts">Use `GET /v1/facts` for concepts such as `RevenueFromContractWithCustomerExcludingAssessedTax` or `Assets`.</Card>
  <Card title="Set up MCP" icon="bot" href="/mcp-install">Install the hosted MCP server, then inspect the transport contract at `POST /mcp`.</Card>
  <Card title="Debug auth and billing errors" icon="circle-help" href="/troubleshooting">Map 401, 402, 429, and MCP JSON-RPC errors to the fastest next action before retrying.</Card>
  <Card title="Inspect prepaid credits" icon="credit-card" href="/api-reference/platform/get-v1-billing-credits">Use `GET /v1/billing/credits` to see credit balance, auto-top-up settings, lifetime totals, and low-balance status.</Card>
</CardGroup>

## Endpoint families

<CardGroup cols={2}>
  <Card title="Advisers" icon="square-stack" href="/api-reference/advisers">Reference pages for Advisers endpoints.</Card>
  <Card title="Agent" icon="bot" href="/api-reference/agent">Provision an agent's first organization-scoped API key through a short-lived sponsor-token exchange.</Card>
  <Card title="Alerts" icon="bell" href="/api-reference/alerts">Public alert-plan and email-registration endpoints; availability is explicitly feature-gated.</Card>
  <Card title="Analytics" icon="chart-column" href="/api-reference/analytics">Tenant-safe analytical query workflows over supported SEC API history datasets.</Card>
  <Card title="Artifacts" icon="package" href="/api-reference/artifacts">Build organization-scoped filing or comparison bundles, then inspect their manifests, exports, downloads, and storage state.</Card>
  <Card title="Board" icon="users-round" href="/api-reference/board">Board composition and director-level governance surfaces derived from SEC proxy disclosures.</Card>
  <Card title="Companies" icon="building-2" href="/api-reference/companies">Build issuer research views from SEC-derived statements, ratios, segments, macro exposure, and company snapshots.</Card>
  <Card title="Compensation" icon="wallet-cards" href="/api-reference/compensation">Compensation and governance-oriented executive pay workflows.</Card>
  <Card title="Delivery" icon="send" href="/api-reference/delivery">Inspect organization-scoped delivery records, export event history, or handle signed email unsubscriptions.</Card>
  <Card title="Dilution" icon="chart-no-axes-combined" href="/api-reference/dilution">Investigate SEC-disclosed dilution signals: offerings, convertibles, warrants, share float, cash, and capital-structure events.</Card>
  <Card title="Earnings materials" icon="mic-2" href="/api-reference/earnings">SEC-furnished earnings materials, coverage state, and transcript-adjacent filing extracts.</Card>
  <Card title="Embed" icon="square-stack" href="/api-reference/embed">Reference pages for Embed endpoints.</Card>
  <Card title="Entities" icon="building-2" href="/api-reference/entities">Resolve and search best-match public-market entities across issuers, managers, insiders, and funds.</Card>
  <Card title="Event Types" icon="square-stack" href="/api-reference/event_types">Reference pages for Event Types endpoints.</Card>
  <Card title="Events" icon="git-merge" href="/api-reference/events">Search disclosure-derived M\&A, restatement, auditor, officer, voting, IPO, and SEC enforcement events before reviewing the cited filing or release.</Card>
  <Card title="Factors" icon="square-stack" href="/api-reference/factors">Reference pages for Factors endpoints.</Card>
  <Card title="Facts" icon="square-stack" href="/api-reference/facts">Reference pages for Facts endpoints.</Card>
  <Card title="Filings" icon="file-text" href="/api-reference/filings">Find filing records and move from search results into retrieval, extraction, download, export, or latest-filing views.</Card>
  <Card title="Forms" icon="file-text" href="/api-reference/forms">Locate filed capital-formation, insider-sale, and fund-disclosure records without treating filing discovery as transaction completion.</Card>
  <Card title="Fund Letters" icon="square-stack" href="/api-reference/fund-letters">Reference pages for Fund Letters endpoints.</Card>
  <Card title="Funds" icon="square-stack" href="/api-reference/funds">Reference pages for Funds endpoints.</Card>
  <Card title="Insiders" icon="badge-dollar-sign" href="/api-reference/insiders">Insider transaction history and actor-level trading surfaces.</Card>
  <Card title="Intelligence" icon="square-stack" href="/api-reference/intelligence">Reference pages for Intelligence endpoints.</Card>
  <Card title="Macro" icon="landmark" href="/api-reference/macro">Retrieve country macro indicators, releases, forecasts, regimes, and source-aware coverage for supported markets.</Card>
  <Card title="Market utilities" icon="calendar-range" href="/api-reference/market">Market calendars, security reference, and reusable market utility endpoints.</Card>
  <Card title="Models" icon="square-stack" href="/api-reference/models">Reference pages for Models endpoints.</Card>
  <Card title="Monitors" icon="bell-ring" href="/api-reference/monitors">Organization-scoped saved searches, match reads, delivery destinations, and structured-monitor compilation.</Card>
  <Card title="News" icon="square-stack" href="/api-reference/news">Reference pages for News endpoints.</Card>
  <Card title="Offerings" icon="briefcase-business" href="/api-reference/offerings">Find filed registration statements and prospectuses for public-offering research, with filing-date filters and source-aware review guidance.</Card>
  <Card title="Ownership" icon="users" href="/api-reference/owners">Institutional and beneficial ownership surfaces for managers, holders, and ticker-centric analysis.</Card>
  <Card title="Platform" icon="bolt" href="/api-reference/platform">Set up and manage your SEC API organization: authenticate clients, create API keys, inspect limits, and manage billing.</Card>
  <Card title="Portfolio" icon="square-stack" href="/api-reference/portfolio">Reference pages for Portfolio endpoints.</Card>
  <Card title="Search" icon="square-stack" href="/api-reference/search">Reference pages for Search endpoints.</Card>
  <Card title="Sections" icon="braces" href="/api-reference/sections">Search and extract filing sections, items, and snippets.</Card>
  <Card title="Signals" icon="activity" href="/api-reference/signals">Derived public-market signals such as the SEC API Volatility Score.</Card>
  <Card title="Situations" icon="square-stack" href="/api-reference/situations">Reference pages for Situations endpoints.</Card>
  <Card title="Statements" icon="table-properties" href="/api-reference/statements">Retrieve normalized financial statements and segment disclosures with periods, units, and filing provenance.</Card>
  <Card title="Stocks" icon="square-stack" href="/api-reference/stocks">Reference pages for Stocks endpoints.</Card>
  <Card title="Strategies" icon="square-stack" href="/api-reference/strategies">Reference pages for Strategies endpoints.</Card>
  <Card title="Stream" icon="square-stack" href="/api-reference/stream">Reference pages for Stream endpoints.</Card>
  <Card title="Streams" icon="waves" href="/api-reference/streams">Stream subscription creation and event polling for replay-safe event delivery.</Card>
  <Card title="Traces" icon="waypoints" href="/api-reference/traces">Trace hydration, filing page anchors, and source-to-derived lineage workflows. Traces cover filing-derived data (segmented revenues, section excerpts), SEC enforcement actions, market price snapshots, and analyst estimates.</Card>
  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks">Organization webhook endpoints, signed event delivery, recorded attempts, replay, and one-time secret rotation.</Card>
</CardGroup>

## Canonical wire contract

* OpenAPI JSON: [`/openapi/sec-api.v1.json`](/openapi/sec-api.v1.json)
* Base URL: `https://api.secapi.ai`
* API key env var: `SECAPI_API_KEY`
* Version header: `secapi-version` set to the current published version.
