GET /v1/entities/resolve - 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/entities/resolve?ticker=AAPL&view=agent"

{
  "object": "entity",
  "id": "cent_example",
  "name": "Example Issuer, Inc.",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "primaryIdentifiers": [
    {
      "type": "ticker",
      "value": "EXAMPLE"
    },
    {
      "type": "cik",
      "value": "0000000000"
    }
  ],
  "matchConfidence": 1,
  "matchBasis": "ticker",
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Resolve one issuer, manager, insider, or fund from a market or SEC identifier, returning the canonical entity and match confidence

Audience: engineers and agents normalizing an issuer, fund, manager, or insider before another SEC API call.

Agent mode

Pass ?view=agent to receive the compact agent shape: entity identifiers (id, ticker, cik, name) + primary identifiers + match metadata. Aliases, jurisdiction, full identifiers list, and metadata envelopes are dropped. See api conventions → response formats for the full ?view= contract.

Canonical metadata

id
name
ticker
cik
primaryIdentifiers
matchConfidence
matchBasis
requestId

Example request

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

Example response

{
  "object": "entity",
  "id": "cent_example",
  "name": "Example Issuer, Inc.",
  "ticker": "EXAMPLE",
  "cik": "0000000000",
  "primaryIdentifiers": [
    {
      "type": "ticker",
      "value": "EXAMPLE"
    },
    {
      "type": "cik",
      "value": "0000000000"
    }
  ],
  "matchConfidence": 1,
  "matchBasis": "ticker",
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Resolution and coverage

Send one stable identifier when possible. ticker wins over symbol; name, query, and q are fallback aliases, not a guarantee of a unique legal entity. Preserve matchConfidence and matchBasis before joining this result to filings, facts, or ownership data. See API conventions for identity, response-shape, and request-correlation rules.

Errors

A blank identifier is 400 missing_identifier; an identifier that cannot be resolved is 404 entity_not_found. Do not turn either condition into a guessed ticker or CIK.

Give this prompt to your agent

Failure posture

retain matchConfidence, matchBasis, and requestId with the lookup result
on 400 missing_identifier, supply one nonblank identifier
on 404 entity_not_found, request a corrected identifier instead of guessing

GET /v1/entities/edgar Event types

​Agent mode

​Canonical metadata

​Example request

​Example response

​Resolution and coverage

​Errors

​Give this prompt to your agent

​Failure posture

Agent mode

Canonical metadata

Example request

Example response

Resolution and coverage

Errors

Give this prompt to your agent

Failure posture