Financial Statements

Get balance sheets

Changed on

Get balance sheets for a ticker.

get/financials/balance-sheets

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

tickerstring

The ticker symbol. Required if cik or isin is not provided.

period'annual' | 'quarterly' | 'ttm' required

The time period of the balance sheets.

limitinteger

The maximum number of balance sheets to return This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cikstring

The Central Index Key (CIK) of the company.

market'US' | 'UK' | 'FR'

The market the company is listed in: US (the default), UK or FR. Any ticker of the company, including a second share class, returns the company's statements.

exchangestring

Deprecated alias of market: LSE means market=UK. Existing requests keep working. France has no alias: name it with market=FR.

isinstring

The ISIN (International Securities Identification Number) of a non-US listing. An alternative to ticker and market.

report_periodstring date

Filter by exact report period date in YYYY-MM-DD format.

report_period_gtestring date

Filter by report period greater than or equal to date in YYYY-MM-DD format.

report_period_ltestring date

Filter by report period less than or equal to date in YYYY-MM-DD format.

report_period_gtstring date

Filter by report period greater than date in YYYY-MM-DD format.

report_period_ltstring date

Filter by report period less than date in YYYY-MM-DD format.

filing_datestring date

Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gtestring date

Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_ltestring date

Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.

filing_date_gtstring date

Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_ltstring date

Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Balance sheets response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Changes

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter exchange

    • info

      added the new optional query request parameter isin

    • info

      added the new optional query request parameter market

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status