Skip to main content
Company facts describe the identity of each issuer in a scenario: name, sector, industry, exchange, CIK, and listing metadata. Identity is grounded in real reference data; everything financial is synthetic. See Ticker universe.

​
Company facts

GET /company/facts
Returns facts for a single company by ticker or cik.
ParameterTypeRequiredDescription
scenario_idstringYesThe world to read from.
tickerstringNoSymbol to look up.
cikstringNoCIK to look up (alternative to ticker).
curl -s "https://api.davidhf.com/company/facts?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "company_facts": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "cik": "0000320193",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "category": "Operating Company",
    "exchange": "NASDAQ",
    "is_active": true,
    "location": "Cupertino, CA",
    "sic_code": "3571",
    "sic_industry": "Electronic Computers",
    "sic_sector": "Manufacturing",
    "sec_filings_url": "https://.../cik=0000320193"
  }
}
Returns 404 if the company is not found in the scenario.

​
List companies

GET /companies
List or search companies in a scenario.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNo-Filter to a single ticker.
searchstringNo-Free-text search over name, sector, industry, or ticker (≤128 chars).
limitintegerNo100Page size (max 5000).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/companies?scenario_id=<id>&search=semiconductor&limit=25" \
  -H "X-API-KEY: YOUR_API_KEY"

{ "companies": [ { "ticker": "NVDA", "name": "NVIDIA Corp.", "sector": "Technology", "...": "..." } ] }

​
Discovery helpers

List the identifiers actually present in a scenario. 
GET /company/facts/tickers

{ "tickers": ["AAPL", "MSFT", "NVDA", "..."] }

GET /company/facts/ciks

{ "ciks": ["0000320193", "0000789019", "..."] }
Both take only scenario_id. 
curl -s "https://api.davidhf.com/company/facts/tickers?scenario_id=<id>" \
  -H "X-API-KEY: YOUR_API_KEY"