Skip to main content
Use this page to make a small live request before you build a larger workflow. Resolve a company first, then use the returned identity to choose the filing, statement, or search request you need.
These examples call the production API and count against your usage quota.

​
Set your API key

Create an account at secapi.ai/signup, create an API key in the signed-in dashboard, and expose it only to the process making the request. 
export SECAPI_API_KEY="secapi_..."
Send the key in x-api-key. Do not put it in browser code, a checked-in file, or an Authorization: Bearer header.

​
Resolve a company

This request resolves Apple and returns its canonical CIK and identity metadata. id is SEC API’s opaque canonical identifier for the resolved issuer; only requestId varies by request. 
curl -sS \
  -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL&view=agent"

const response = await fetch(
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL&view=agent",
  { headers: { "x-api-key": process.env.SECAPI_API_KEY } },
)

const entity = await response.json()
console.log(entity.ticker, entity.cik, entity.name, entity.requestId)

import os

import requests

response = requests.get(
    "https://api.secapi.ai/v1/entities/resolve",
    params={"ticker": "AAPL", "view": "agent"},
    headers={"x-api-key": os.environ["SECAPI_API_KEY"]},
)
entity = response.json()
print(entity["ticker"], entity["cik"], entity["name"], entity["requestId"])

secapi entities resolve --ticker AAPL
On success, confirm that the result includes ticker, cik, name, and requestId. Keep the request ID with your logs. For the complete set of accepted identifiers and response fields, read the entity resolution reference.

​
Retrieve a filing

Once entity resolution works, retrieve the latest 10-K. The filing can change as new reports arrive, so retain the source fields from the response rather than expecting a fixed accession number. 
curl -sS \
  -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/filings/latest?ticker=AAPL&form=10-K&view=agent"
Keep accessionNumber, filingDate, filingUrl, and requestId with any result derived from the filing. The latest filing reference documents the available filters and response shape.

​
Pick the next page

Build an application

Choose an SDK for JavaScript, Python, Go, or Rust application code.

Work from a terminal

Use the CLI for shell scripts and interactive investigation.

Use an MCP client

Connect hosted MCP for source-backed research workflows.
Read API conventions before adding pagination, version pinning, or retry logic. Read Troubleshooting when a request returns an error.