Skip to main content

​
SEC filings API

Access complete SEC filing documents (10-K annual reports, 10-Q quarterly reports, 8-K current events) stored in S3 with metadata in PostgreSQL.
This endpoint serves the complete filing documents. For intelligent retrieval and Q&A over SEC filings, use the SEC Agent via the chat endpoint.

​
Get available filings

Retrieve list of available SEC filings for a company. Endpoint: GET /sec-filings/{ticker}/available

​
Path parameters

​
ticker
string
required
Company ticker symbol (e.g., “AAPL”, “MSFT”)

​
Query parameters

​
filing_type
string
Filter by filing type: “10-K”, “10-Q”, or “8-K” (optional)

​
Response

​
filings
array
List of available filings

​
Example

curl https://api.financeagent.com/sec-filings/AAPL/available?filing_type=10-K

​
Get filing document

Retrieve complete SEC filing document in markdown format. Endpoint: GET /sec-filings/{ticker}/{filing_type}/{fiscal_year}

​
Path parameters

​
ticker
string
required
Company ticker symbol
​
filing_type
string
required
Filing type: “10-K”, “10-Q”, or “8-K”
​
fiscal_year
integer
required
Fiscal year (returns most recent filing for that year or earlier)

​
Response

​
ticker
string
Company ticker
​
filing_type
string
Filing type
​
fiscal_year
integer
Fiscal year
​
filing_date
string
Date filed
​
company_name
string
Official company name
​
document_length
integer
Document size in characters
​
markdown
string
Complete filing document in markdown format

​
Example

curl https://api.financeagent.com/sec-filings/AAPL/10-K/2023

​
Get filing with highlights

Retrieve SEC filing with relevant sections highlighted based on search context. Endpoint: POST /sec-filings/with-highlights
Requires authentication. This endpoint highlights relevant sections from the filing based on chunks returned by the SEC agent.

​
Request body

​
ticker
string
required
Company ticker
​
filing_type
string
required
Filing type: “10-K”, “10-Q”, or “8-K”
​
fiscal_year
integer
required
Fiscal year
​
quarter
integer
Quarter (1-4) for 10-Q filings
​
relevant_chunks
array
Array of chunk objects with text and metadata to highlight

​
Response

Same as GET endpoint but with <mark> tags injected around relevant sections.

​
Example

curl -X POST https://api.financeagent.com/sec-filings/with-highlights \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "ticker": "AAPL",
    "filing_type": "10-K",
    "fiscal_year": 2023,
    "relevant_chunks": [
      {
        "chunk_text": "executive compensation",
        "sec_section": "item_11"
      }
    ]
  }'

​
Storage architecture

Metadata

PostgreSQL stores filing metadata: ticker, fiscal year, filing date, document length

Documents

Railway S3 bucket stores complete markdown documents with section structure

​
Use cases

Retrieve full annual report with all sections (Business, Risk Factors, Financial Statements, etc.)
Get quarterly reports with financial data and management discussion
Access material event disclosures (earnings releases, leadership changes, acquisitions)
Display filing with specific sections highlighted based on search query

Chat API

Ask questions about SEC filings using the intelligent SEC agent

SEC Agent

Learn about the planning-driven retrieval system

Build docs developers (and LLMs) love

Get started for freeTalk to us