Skip to main content

​
First Request Flows

This page exists to get you to one clean success quickly. Do one real workflow, keep the request metadata, and only then widen the scope.

​
Start in three steps

1

Check platform status

Confirm health and readiness before you spend time debugging auth or payload shape.
2

Resolve one issuer you know

Start with a company such as AAPL so you can tell whether the answer looks obviously wrong.
3

Pull one structured workflow

Fetch a latest filing, extract a section, or pull the all-statements bundle. That is enough to prove the integration is alive.

​
API first request

curl "https://api.secapi.ai/healthz"

curl -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL"

curl -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/statements/all?ticker=AAPL&period=annual&limit=1"

Copy this SEC API prompt for your agent.

​
CLI first request

secapi entities resolve --ticker AAPL --json
secapi filings latest --ticker AAPL --form 10-K --json
secapi sections get --ticker AAPL --form 10-K --section item_1a --json

​
SDK first request

import { SecApiClient } from "@secapi/sdk-js"

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

const issuer = await client.resolveEntity({ ticker: "AAPL" })
const filing = await client.latestFiling({ ticker: "AAPL", form: "10-K" })
const section = await client.latestSection({
  ticker: "AAPL",
  form: "10-K",
  section: "item_1a",
})

Copy this SEC API prompt for your agent.

​
MCP first request

entities.resolve

Confirm the hosted MCP path can resolve a known issuer.

filings.latest

Pull the latest filing for a known form and issuer.

sections.get

Extract one section so you validate a useful workflow, not just connectivity.

​
Keep this support packet

Interface used

Note whether the request came from REST, SDK, CLI, or MCP.

Endpoint or tool

Record the literal endpoint or tool name.

Request metadata

Keep Request-Id, the expected result, and the actual result.