FocusAlphaDocs
Get key
API Reference

Company Facts

Reference metadata for a company — name, CIK, SIC industry and sector, filer category, exchange, and location — straight from SEC EDGAR. The lookup you call once to enrich a ticker before fetching its filings or financials.

GET/v1/company/facts

Query parameters#

tickerstringoptional
US ticker, e.g. AAPL. Provide ticker or cik (at least one is required).
cikstringoptional
SEC Central Index Key — an alternative to ticker.

Example request#

curlbash
curl "https://api.focusalpha.ai/v1/company/facts?ticker=AAPL" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

Response#

Returns a single company_facts object.

Resolves across SEC EDGAR
Company facts come straight from SEC submissions, so this lookup resolves any company EDGAR knows — a broader set than the ~2,000-company financials universe. A ticker can return facts here and still have no structured statements; see Financials coverage for which companies carry financial statements.
Every field is always present
The company_facts object is a fixed shape — every field below is always emitted. When a value is unknown, string fields are the empty string "" (never null) and is_active is false.
tickerstringrequired
Company ticker.
namestringrequired
Registrant name, e.g. Apple Inc.
cikstringrequired
SEC Central Index Key, zero-padded, e.g. 0000320193.
sectorstringrequired
SIC sector classification (empty string when unmapped).
industrystringrequired
SIC industry classification (empty string when unmapped).
sic_codestringrequired
The numeric SIC code, e.g. 3571 (empty string when absent). Also sic_industry and sic_sector as labels.
sic_industrystringrequired
SIC major-group label, derived from sic_code (empty string when unmapped).
sic_sectorstringrequired
SIC division label, derived from sic_code (empty string when unmapped).
categorystringrequired
SEC filer category, e.g. Large accelerated filer (empty string when absent).
exchangestringrequired
Listing exchange, e.g. Nasdaq (empty string when absent).
is_activebooleanrequired
Whether the company is an active filer.
locationstringrequired
Headquarters location, e.g. CUPERTINO, CA (empty string when absent).
sec_filings_urlstringrequired
Link to the company's filing history on SEC EDGAR.

Example response#

response.jsonjson
{
  "company_facts": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "sector": "Manufacturing",
    "industry": "Industrial And Commercial Machinery And Computer Equipment",
    "category": "Large accelerated filer",
    "exchange": "Nasdaq",
    "is_active": true,
    "location": "CUPERTINO, CA",
    "sic_code": "3571",
    "sic_industry": "Industrial And Commercial Machinery And Computer Equipment",
    "sic_sector": "Manufacturing",
    "sec_filings_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193&type=&dateb=&owner=include&count=40"
  }
}

Discovery endpoints#

List the universe covered by Company Facts. No query parameters.

GET /v1/company/facts/tickersGEToptional
Every covered ticker: { resource: "company-facts", tickers: [...] }.
GET /v1/company/facts/ciksGEToptional
Every covered CIK (zero-padded to 10): { resource: "company-facts", ciks: [...] }.

Errors#

Statuses: 400 (missing both ticker and cik), 401 (bad or missing API key), 402 (per-minute rate limit or monthly quota exceeded), 404 (unknown company), 503 (SEC upstream temporarily rate-limited; carries a Retry-After header — retry shortly), and 500. See Errors.