Annual fundamentals for one company.

get/api/v1/companies/{ticker}

Request

  • Base URL: https://tickerfacts.com
  • URL: https://tickerfacts.com/api/v1/companies/{ticker}
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

tickerstring required

US ticker symbol, e.g. AAPL

Query parameters

periodsstring

Newest annual period groups to return; omitted means all (with quarters, the newest 1).

quartersstring

Newest fiscal quarters to return (1 to 12), in quarterly.

period'annual' | 'quarterly'

quarterly returns the newest 8 fiscal quarters unless quarters is given.

metricsstring

Comma-separated metric or ratio keys (gross_margin, operating_margin, net_margin, return_on_equity, liabilities_to_equity, long_term_debt_to_equity, revenue_growth, or <metric>_growth); omitted means all metrics and ratios.

Response

Annual observations with units, filing dates and source URLs.

cikinteger required
data_qualitystring[]

Warnings about the figures themselves, such as out-of-scale values from a unit tagged wrongly.

dataset_built_atstring required
dataset_sha256string nullable required
display_namestring required

Readable form of name for display; match filings on cik, not this.

evidence_urlstring required
exchangestring nullable required
listing_status'current' | 'former' required

former: the company has left SEC's current ticker directory; its figures are its last filings and will not update.

metric_definitionsobject required
namestring required

SEC conformed (legal) name, as filed.

noticestring required

Figures may be incomplete or wrong and are not investment advice; keep this caveat when passing figures on.

requested_tickerstring nullable required
research_urlstring required
sec_history_urlstring required
sourcestring required
termsstring uri required

Terms of use, which apply to API and agent use.

tickerstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.