Start with the JavaScript SDK

npm install @secapi/sdk-js
export SECAPI_API_KEY="secapi_..."

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

const sec = new SecApiClient()

try {
  const filing = await sec.agentLatestFiling({
    ticker: "AAPL",
    form: "10-K",
  })

  console.log(JSON.stringify({
    accessionNumber: filing.accessionNumber,
    filingDate: filing.filingDate,
    filingUrl: filing.filingUrl,
    requestId: filing.requestId,
  }, null, 2))
} catch (error) {
  if (error instanceof SecApiError) {
    console.error({ status: error.status, code: error.code, requestId: error.requestId })
    process.exitCode = 1
  } else {
    throw error
  }
}

node first-request.mjs

const roster = await sec.situations.list({ types: ["merger"], statuses: ["pending"], limit: 25 })
const detail = await sec.situations.get("sit_abc123")
const byForm = await sec.situations.byForm("SC 13D", { limit: 25 })
const filings = await sec.situations.filings("sit_abc123", { limit: 25 })
const summary = await sec.situations.summary("sit_abc123")