GET /v1/events/ipo - SEC API for AI

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/events/ipo?ticker=AAPL&limit=10"

{
  "object": "list",
  "data": [],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Find filing-derived IPO and public-offering candidates from registration filings

Audience: application and coding agent.

Coverage and source scope

Finds IPO and public-offering candidates inferred from S-1, F-1, and 424B filings; it does not confirm that an offering priced, closed, or began trading. Treat filing dates as disclosure dates, preserve accession and source fields, and continue with the returned nextCursor value for the same filters. The supported forms and bounded submission scan define coverage, so no result is not proof that no offering occurred. See API conventions.

Canonical metadata

requestId
traceparent
per-row provenance
per-row freshness
per-row materialization

Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/events/ipo?ticker=AAPL&limit=10"

Example response

{
  "object": "list",
  "data": [],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

​Coverage and source scope

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture