stocks tool
Partial for public keysstocks_get_company_facts
Identity + dataset-coverage profile for one US public company.
Public-key response
Provider-licensed price coverage is omitted for public keys (reported unavailable); omitted sources are disclosed via meta.restricted_omitted.
Description
Identity + dataset-coverage profile for one US public company.
The result is the shared envelope (pagination null — a single
profile). data holds the company identity (cik, name, exchange,
sector, sic_code, sic_description), its tickers (each with
symbol, active, and validity dates — delisted/renamed symbols
included so you can recognise a historical ticker), fiscal_year_end
(MM-DD of the latest annual period, or null), latest_filing_date,
and a coverage summary. meta carries source and the profile's
as_of.
sic_code/sic_description are the SEC's own classification from the
filer's EDGAR submissions record; sector is a coarse bucket derived
from it and is the same vocabulary stocks_screen filters on. All three
are null for a company we have not classified yet — absence means
unknown, not "unclassifiable".
coverage has one entry per dataset — financials, prices,
filings — each {available, since, through}. Read it before asking
for data: if coverage.prices.available is false we hold no prices for
this company, and since/through bound the range you can actually
request. This prevents asking for data we do not have. On the public
surface, provider-licensed price coverage is omitted (reported
unavailable) and the excluded sources are listed in
meta.restricted_omitted.
A well-formed ticker we hold no mapping for returns unknown_entity,
with Did you mean: …? suggestions when a close match exists; a string
that is neither a ticker nor a CIK returns bad_parameter (use
stocks_search_tickers for names).
Parameters
Input schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| ticker_or_cik | string | Yes | — | An exact ticker ('AAPL', 'BRK.B') or a numeric SEC CIK ('320193', zero-padded accepted). For a company *name*, call stocks_search_tickers first — this tool does not fuzzy-match. |
Provenance
Sources
- sec_company_tickersU.S. Securities and Exchange Commission (EDGAR)
- sec_edgar_companyfactsU.S. Securities and Exchange Commission (EDGAR)
- sec-edgar-submissionsU.S. Securities and Exchange Commission (EDGAR)
tiingoProvider-licensed source; not served to public keys