Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Entity Resolution & Mapping API

Resolve any company identifier — CIK, ticker, FIGI, ISIN, CUSIP, or name — to a canonical entity record with exchange, sector, industry, and SIC code. The entity graph powers identity joins across the rest of SEC API.

​
Why use this

Financial data systems break when entity identity is ambiguous. SEC API Entity Resolution maintains a canonical graph of issuers, filers, managers, insiders, funds, and aliases so downstream queries do not need to rebuild identity logic on every call.
  • Six identifier types — CIK, ticker, FIGI, ISIN, CUSIP, and company name
  • Canonical entity graph — issuers, filers, managers, insiders, funds, and aliases resolved to a single identity
  • Structured metadata — exchange, sector, industry, SIC code, and entity type on every record
  • Alias resolution — historical tickers, name changes, and cross-identifier mappings
  • Batch-friendly — resolve multiple identifiers in a single request

​
Quick start

# Resolve by ticker
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL"

# Resolve by CIK
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?cik=0000320193"

# Resolve by name
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?name=Apple+Inc"

​
Example: search entities

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities?query=tesla&limit=5"

​
Response shape

{
  "entity": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "figi": "BBG000B9XRY4",
    "isin": "US0378331005",
    "cusip": "037833100",
    "exchange": "NASDAQ",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "sicCode": "3571",
    "sicDescription": "Electronic Computers",
    "entityType": "issuer",
    "aliases": [
      { "type": "formerName", "value": "APPLE COMPUTER INC" }
    ]
  }
}

​
Key parameters

ParameterTypeDescription
tickerstringCompany ticker symbol
cikstringSEC Central Index Key
figistringOpenFIGI identifier
isinstringInternational Securities Identification Number
cusipstringCUSIP identifier
namestringCompany name (fuzzy matched)
querystringSearch query for entity listing
limitnumberResults per page (entity search only)

​
Rate limits

Rate limits vary by plan and workload. Entity resolution is a lightweight lookup operation, but production clients should still handle 429 responses and retry safely.