---
title: "Stock Financials vX"
method: GET
path: "/vX/reference/financials"
tags: ["reference:stocks"]
---

# Stock Financials vX

`GET /vX/reference/financials`

Get historical financial data for a stock ticker.
The financials data is extracted from XBRL from company SEC filings using the methodology outlined <a rel="noopener noreferrer nofollow" target="_blank" href="http://xbrl.squarespace.com/understanding-sec-xbrl-financi/">here</a>.

## Query parameters

- `ticker` string
- `cik` string
- `company_name` string
- `sic` string
- `filing_date` string, date
- `period_of_report_date` string, date
- `timeframe` 'annual' | 'quarterly' | 'ttm'
- `include_sources` boolean
- `company_name.search` string
- `filing_date.gte` string, date
- `filing_date.gt` string, date
- `filing_date.lte` string, date
- `filing_date.lt` string, date
- `period_of_report_date.gte` string, date
- `period_of_report_date.gt` string, date
- `period_of_report_date.lte` string, date
- `period_of_report_date.lt` string, date
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'filing_date' | 'period_of_report_date'

## Response `200`

FIXME

- object
  - `count` integer, required — The total number of results for this request.
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — An array of results containing the requested data.
    - `acceptance_datetime` string — The datetime (EST timezone) the filing was accepted by EDGAR in YYYYMMDDHHMMSS format.
    - `cik` string, required — The CIK number for the company.
    - `company_name` string, required — The company name.
    - `end_date` string — The end date of the period that these financials cover in YYYYMMDD format.
    - `filing_date` string — The date that the SEC filing which these financials were derived from was made available. Note that this is not necessarily the date when this information became public, as some companies may publish a press release before filing with the SEC.
    - `financials` object, required — Structured financial statements with detailed data points and metadata.
      - `balance_sheet` object — Balance sheet. The keys in this object can be any of the fields listed in the Balance Sheet section of the <a target="_blank" href="https://massive.com/blog/financials-api-glossary-of-fields">financials API glossary of terms</a>.
        - `*` object — An individual financial data point.
          - `derived_from` string[] — The list of report IDs (or errata) which were used to derive this data point. This value is only returned for data points taken directly from XBRL when the `include_sources` query parameter is `true` and if source is SourceInterReportDerived.
          - `formula` string — The name of the formula used to derive this data point from other financial data points. Information about the formulas can be found <a rel="noopener noreferrer nofollow" target="_blank" href="http://xbrlsite.azurewebsites.net/2020/reporting-scheme/us-gaap/fac/documentation/ImputeRulesList.html">here</a>. This value is only returned for data points that are not explicitly expressed within the XBRL source file when the `include_sources` query parameter is `true` and if source is SourceIntraReportImpute.
          - `label` string, required — A human readable label for the financial data point.
          - `order` integer, required — An indicator of what order within the statement that you would find this data point.
          - `source` string — The source where this data point came from. This will be one of: SourceDirectReport, SourceIntraReportImpute or SourceInterReportDerived.
          - `unit` string, required — The unit of the financial data point.
          - `value` number, required — The value of the financial data point.
          - `xpath` string — The <a rel="noopener noreferrer nofollow" target="_blank" href="https://en.wikipedia.org/wiki/XPath">XPath 1.0</a> query that identifies the fact from within the XBRL source file. This value is only returned for data points taken directly from XBRL when the `include_sources` query parameter is `true` and if source is SourceDirectReport.
      - `cash_flow_statement` object — Cash flow statement. The keys in this object can be any of the fields listed in the Cash Flow Statement section of the <a target="_blank" href="https://massive.com/blog/financials-api-glossary-of-fields">financials API glossary of terms</a>. See the attributes of the objects within `balance_sheet` for more details.
      - `comprehensive_income` object — Comprehensive income. The keys in this object can be any of the fields listed in the Comprehensive Income section of the <a target="_blank" href="https://massive.com/blog/financials-api-glossary-of-fields">financials API glossary of terms</a>. See the attributes of the objects within `balance_sheet` for more details.
      - `income_statement` object — Income statement. The keys in this object can be any of the fields listed in the Income Statement section of the <a target="_blank" href="https://massive.com/blog/financials-api-glossary-of-fields">financials API glossary of terms</a>. See the attributes of the objects within `balance_sheet` for more details.
    - `fiscal_period` string, required — Fiscal period of the report according to the company (Q1, Q2, Q3, Q4, or FY).
    - `fiscal_year` string — Fiscal year of the report according to the company.
    - `sic` string — The Standard Industrial Classification (SIC) code for the company.
    - `source_filing_file_url` string — The URL of the specific XBRL instance document within the SEC filing that these financials were derived from.
    - `source_filing_url` string — The URL of the SEC filing that these financials were derived from.
    - `start_date` string — The start date of the period that these financials cover in YYYYMMDD format.
    - `tickers` string[] — The list of ticker symbols for the company.
    - `timeframe` string, required — The timeframe of the report (quarterly, annual or ttm).
  - `status` string, required — The status of this request's response.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)