Skip to main content

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 Playground

Try SEC API endpoints with pre-populated examples. Copy any command to use with your own API key.
These examples use live SEC API endpoints. Get an API key to run them yourself.

Entity Resolution

Resolve a company by ticker, CIK, FIGI, or name:
curl "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL" \
  -H "x-api-key: $SECAPI_API_KEY"
Search SEC filings with 20+ filters:
curl "https://api.secapi.ai/v1/filings?ticker=AAPL&form=10-K&limit=3" \
  -H "x-api-key: $SECAPI_API_KEY"

Financial Statements

Get structured XBRL financial data:
# All statements for the latest annual period
curl "https://api.secapi.ai/v1/statements/all?ticker=AAPL&period=annual&limit=1" \
  -H "x-api-key: $SECAPI_API_KEY"

Ownership & Insiders

# Insider trades
curl "https://api.secapi.ai/v1/insiders?ticker=AAPL&limit=5" \
  -H "x-api-key: $SECAPI_API_KEY"

# 13F institutional holdings
curl "https://api.secapi.ai/v1/owners/13f?cik=0001067983&limit=10" \
  -H "x-api-key: $SECAPI_API_KEY"

# Executive compensation
curl "https://api.secapi.ai/v1/compensation?ticker=AAPL" \
  -H "x-api-key: $SECAPI_API_KEY"

Enforcement Actions

# Recent enforcement actions
curl "https://api.secapi.ai/v1/events/enforcement?limit=5" \
  -H "x-api-key: $SECAPI_API_KEY"

# Filter by type
curl "https://api.secapi.ai/v1/events/enforcement?source_type=aaer&limit=5" \
  -H "x-api-key: $SECAPI_API_KEY"

Intelligence Bundles

One-call pre-computed analysis:
# Company intelligence bundle
curl "https://api.secapi.ai/v1/intelligence/company?ticker=AAPL" \
  -H "x-api-key: $SECAPI_API_KEY"

# Security analysis
curl "https://api.secapi.ai/v1/intelligence/security?ticker=TSLA" \
  -H "x-api-key: $SECAPI_API_KEY"

Using the CLI

The public CLI package name is @secapi/cli, with the secapi binary:
# Install
npm install -g @secapi/cli

# Set your key
export SECAPI_API_KEY=your_key_here

# Try it
secapi entities resolve --ticker AAPL --json
secapi filings search --ticker AAPL --form 10-K --limit 3 --json
secapi insiders list --ticker AAPL --json

Using the SDK

The public JavaScript SDK package name is @secapi/sdk-js:
import { SecApiClient } from "@secapi/sdk-js"

const client = new SecApiClient({
  apiKey: process.env.SECAPI_API_KEY,
})

const entity = await client.resolveEntity({ ticker: "AAPL" })
const filing = await client.latestFiling({ ticker: "AAPL", form: "10-K" })
const statements = await client.allStatements({ ticker: "AAPL", period: "annual", limit: 1 })