latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

financials

A comprehensive financial dataset containing quarterly and annual balance sheet data for public companies. Includes detailed asset, liability, and equity positions representing the company's financial position at specific points in time. Balance sheet data represents point-in-time snapshots rather than cumulative flows, showing what the company owns, owes, and shareholders' equity as of each period end date.

get/stocks/financials/v1/balance-sheets

Query parameters

cikstring

The company's Central Index Key (CIK), a unique identifier assigned by the U.S. Securities and Exchange Commission (SEC). You can look up a company's CIK using the SEC CIK Lookup tool.

cik.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

cik.gtstring

Filter greater than the value.

cik.gtestring

Filter greater than or equal to the value.

cik.ltstring

Filter less than the value.

cik.ltestring

Filter less than or equal to the value.

tickersstring

Filter for arrays that contain the value.

tickers.all_ofstring

Filter for arrays that contain all of the values. Multiple values can be specified by using a comma separated list.

tickers.any_ofstring

Filter for arrays that contain any of the values. Multiple values can be specified by using a comma separated list.

period_endstring

The last date of the reporting period, representing the specific point in time when the balance sheet snapshot was taken. Value must be formatted 'yyyy-mm-dd'.

period_end.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

period_end.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

period_end.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

period_end.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

filing_datestring

The date of the most recent SEC filing that included this period's data. This is not necessarily the date this period was originally filed. Because SEC filings restate comparative data for prior periods, multiple records can share the same filing_date. For example, an annual 10-K reports three years of results, and a 10-Q includes prior period comparatives. To find the original filing date for a specific 10-K or 10-Q, use the SEC EDGAR filings index endpoint (/stocks/filings/vX/index). Value must be formatted 'yyyy-mm-dd'.

filing_date.gtstring

Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.

filing_date.gtestring

Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

filing_date.ltstring

Filter less than the value. Value must be formatted 'yyyy-mm-dd'.

filing_date.ltestring

Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.

fiscal_yearnumber double

The fiscal year for the reporting period. Value must be a floating point number.

fiscal_year.gtnumber double

Filter greater than the value. Value must be a floating point number.

fiscal_year.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

fiscal_year.ltnumber double

Filter less than the value. Value must be a floating point number.

fiscal_year.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

fiscal_quarternumber double

The fiscal quarter number (1, 2, 3, or 4) for the reporting period. Value must be a floating point number.

fiscal_quarter.gtnumber double

Filter greater than the value. Value must be a floating point number.

fiscal_quarter.gtenumber double

Filter greater than or equal to the value. Value must be a floating point number.

fiscal_quarter.ltnumber double

Filter less than the value. Value must be a floating point number.

fiscal_quarter.ltenumber double

Filter less than or equal to the value. Value must be a floating point number.

timeframestring

The reporting period type. Possible values include: quarterly, annual.

timeframe.any_ofstring

Filter equal to any of the values. Multiple values can be specified by using a comma separated list.

timeframe.gtstring

Filter greater than the value.

timeframe.gtestring

Filter greater than or equal to the value.

timeframe.ltstring

Filter less than the value.

timeframe.ltestring

Filter less than or equal to the value.

limitinteger

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.

sortstring

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'period_end' if not specified. The sort order defaults to 'asc' if not specified.

Response

A list of results.

next_urlstring

If present, this value can be used to fetch the next page.

request_idstring required

A request id assigned by the server.

status'OK' required

The status of this request's response.