Datasets

Get a SEC company's financial-statement history

Returns a company's financial-statement history (income statement, balance sheet, cash flow) from the SEC companies dataset, newest fiscal year first. An unknown CIK or a company with no XBRL data returns an empty series rather than a 404 — most filers without a current ticker have no financial-statement history at all. lines keys are the same concept names the live /sec/financials endpoint uses (e.g. revenue, net_income, total_assets); ratios keys include gross_margin, operating_margin, net_margin, revenue_growth_yoy, current_ratio, debt_to_equity, free_cash_flow where derivable. statement enum: income, balance, cash_flow. period enum: annual, quarterly.

get/datasets/sec-companies/financials/{cik}

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/sec-companies/financials/{cik}
  • Auth: API key in header x-api-key

Path parameters

cikstring required

SEC CIK, numeric or zero-padded

Query parameters

statement'income' | 'balance' | 'cash_flow'

Statement enum: income, balance, cash_flow. Omit to return all three.

period'annual' | 'quarterly'

Period-type enum: annual, quarterly. Omit to return both.

frominteger

Inclusive lower bound on fiscal_year

tointeger

Inclusive upper bound on fiscal_year

limitinteger

Maximum points returned (most recent fiscal years first), default 100, max 400

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.