Polygon Financials API
The financials API from Polygon — 4 operation(s) for financials.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/polygon-financials-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: The future of fintech.
title: Polygon Financials API
version: 1.0.0
servers:
- description: Polygon Platform API
url: https://api.polygon.io
- description: Polygon Platform API (Staging)
url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- name: financials
paths:
/stocks/financials/v1/balance-sheets:
get:
description: 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.
operationId: get_stocks_financials_v1_balance-sheets
parameters:
- description: 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](https://www.sec.gov/search-filings/cik-lookup).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: cik.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: cik.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: cik.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: cik.lte
schema:
type: string
- description: Filter for arrays that contain the value.
in: query
name: tickers
schema:
type: string
- description: Filter for arrays that contain all of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.all_of
schema:
type: string
- description: Filter for arrays that contain any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.any_of
schema:
type: string
- description: 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'.
in: query
name: period_end
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lte
schema:
type: string
- description: 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'.
in: query
name: filing_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lte
schema:
type: string
- description: The fiscal year for the reporting period. Value must be a floating point number.
in: query
name: fiscal_year
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: fiscal_year.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_year.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: fiscal_year.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_year.lte
schema:
format: double
type: number
- description: The fiscal quarter number (1, 2, 3, or 4) for the reporting period. Value must be a floating point number.
in: query
name: fiscal_quarter
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: fiscal_quarter.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_quarter.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: fiscal_quarter.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_quarter.lte
schema:
format: double
type: number
- description: 'The reporting period type. Possible values include: quarterly, annual.'
in: query
name: timeframe
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: timeframe.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: timeframe.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: timeframe.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: timeframe.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: timeframe.lte
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
in: query
name: limit
schema:
default: 100
maximum: 50000
minimum: 1
type: integer
- description: 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.
in: query
name: sort
schema:
default: period_end.asc
type: string
responses:
'200':
content:
application/json:
example:
request_id: d9f86384d43845a4a3d7b79098fb08dd
results:
- accounts_payable: 50374000000
accrued_and_other_current_liabilities: 62499000000
accumulated_other_comprehensive_income: -6369000000
cash_and_equivalents: 36269000000
cik: 0000320193
common_stock: 89806000000
debt_current: 19268000000
deferred_revenue_current: 8979000000
filing_date: '2025-08-01'
fiscal_quarter: 3
fiscal_year: 2025
inventories: 5925000000
long_term_debt_and_capital_lease_obligations: 82430000000
other_assets: 160496000000
other_current_assets: 14359000000
other_equity: 0
other_noncurrent_liabilities: 42115000000
period_end: '2025-06-28'
property_plant_equipment_net: 48508000000
receivables: 46835000000
retained_earnings_deficit: -17607000000
tickers:
- AAPL
timeframe: quarterly
total_assets: 331495000000
total_current_assets: 103388000000
total_current_liabilities: 141120000000
total_equity: 65830000000
total_equity_attributable_to_parent: 65830000000
total_liabilities: 265665000000
total_liabilities_and_equity: 331495000000
status: OK
schema:
properties:
next_url:
description: If present, this value can be used to fetch the next page.
type: string
request_id:
description: A request id assigned by the server.
type: string
results:
description: The results for this request.
items:
properties:
accounts_payable:
description: Amounts owed to suppliers and vendors for goods and services purchased on credit.
format: double
type: number
accrued_and_other_current_liabilities:
description: Current liabilities not classified elsewhere, including accrued expenses, taxes payable, and other obligations due within one year.
format: double
type: number
accumulated_other_comprehensive_income:
description: Cumulative gains and losses that bypass the income statement, including foreign currency translation adjustments and unrealized gains/losses on securities.
format: double
type: number
additional_paid_in_capital:
description: Amount received from shareholders in excess of the par or stated value of shares issued.
format: double
type: number
cash_and_equivalents:
description: Cash on hand and short-term, highly liquid investments that are readily convertible to known amounts of cash.
format: double
type: number
cik:
description: 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](https://www.sec.gov/search-filings/cik-lookup).
type: string
commitments_and_contingencies:
description: Disclosed amount related to contractual commitments and potential liabilities that may arise from uncertain future events.
format: double
type: number
common_stock:
description: Par or stated value of common shares outstanding representing basic ownership in the company.
format: double
type: number
debt_current:
description: Short-term borrowings and the current portion of long-term debt due within one year.
format: double
type: number
deferred_revenue_current:
description: Customer payments received in advance for goods or services to be delivered within one year.
format: double
type: number
filing_date:
description: 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).
format: date
type: string
fiscal_quarter:
description: The fiscal quarter number (1, 2, 3, or 4) for the reporting period.
format: double
type: number
fiscal_year:
description: The fiscal year for the reporting period.
format: double
type: number
goodwill:
description: Intangible asset representing the excess of purchase price over fair value of net assets acquired in business combinations.
format: double
type: number
intangible_assets_net:
description: Intangible assets other than goodwill, including patents, trademarks, and customer relationships, net of accumulated amortization.
format: double
type: number
inventories:
description: Raw materials, work-in-process, and finished goods held for sale in the ordinary course of business.
format: double
type: number
long_term_debt_and_capital_lease_obligations:
description: Long-term borrowings and capital lease obligations with maturities greater than one year.
format: double
type: number
noncontrolling_interest:
description: Equity in consolidated subsidiaries not owned by the parent company, representing minority shareholders' ownership.
format: double
type: number
other_assets:
description: Non-current assets not classified elsewhere, including long-term investments, deferred tax assets, and other long-term assets.
format: double
type: number
other_current_assets:
description: Current assets not classified elsewhere, including prepaid expenses, taxes receivable, and other assets expected to be converted to cash within one year.
format: double
type: number
other_equity:
description: Equity components not classified elsewhere in shareholders' equity.
format: double
type: number
other_noncurrent_liabilities:
description: Non-current liabilities not classified elsewhere, including deferred tax liabilities, pension obligations, and other long-term liabilities.
format: double
type: number
period_end:
description: The last date of the reporting period, representing the specific point in time when the balance sheet snapshot was taken.
format: date
type: string
preferred_stock:
description: Par or stated value of preferred shares outstanding with preferential rights over common stock.
format: double
type: number
property_plant_equipment_net:
description: Tangible fixed assets used in operations, reported net of accumulated depreciation.
format: double
type: number
receivables:
description: Amounts owed to the company by customers and other parties, primarily accounts receivable, net of allowances for doubtful accounts.
format: double
type: number
retained_earnings_deficit:
description: Cumulative net income earned by the company less dividends paid to shareholders since inception.
format: double
type: number
short_term_investments:
description: Marketable securities and other investments with maturities of one year or less that are not classified as cash equivalents.
format: double
type: number
tickers:
description: A list of ticker symbols under which the company is listed. Multiple symbols may indicate different share classes for the same company.
items:
type: string
type: array
timeframe:
description: 'The reporting period type. Possible values include: quarterly, annual.'
type: string
total_assets:
description: Sum of all current and non-current assets representing everything the company owns or controls.
format: double
type: number
total_current_assets:
description: Sum of all current assets expected to be converted to cash, sold, or consumed within one year.
format: double
type: number
total_current_liabilities:
description: Sum of all liabilities expected to be settled within one year.
format: double
type: number
total_equity:
description: Sum of all equity components representing shareholders' total ownership interest in the company.
format: double
type: number
total_equity_attributable_to_parent:
description: Total shareholders' equity attributable to the parent company, excluding noncontrolling interests.
format: double
type: number
total_liabilities:
description: Sum of all current and non-current liabilities representing everything the company owes.
format: double
type: number
total_liabilities_and_equity:
description: Sum of total liabilities and total equity, which should equal total assets per the fundamental accounting equation.
format: double
type: number
treasury_stock:
description: Cost of the company's own shares that have been repurchased and are held in treasury, typically reported as a negative value.
format: double
type: number
required:
- timeframe
type: object
type: array
status:
description: The status of this request's response.
enum:
- OK
type: string
required:
- status
- request_id
- results
type: object
description: A list of results.
'400':
content:
application/json:
schema:
properties:
error:
description: A message describing the source of the error.
type: string
request_id:
description: A request id assigned by the server.
type: string
status:
description: The status of this request's response.
enum:
- ERROR
type: string
required:
- status
- request_id
- error
type: object
description: An error message.
tags:
- financials
/stocks/financials/v1/cash-flow-statements:
get:
description: A comprehensive financial dataset containing quarterly, annual, and trailing twelve-month cash flow statement data for public companies. Includes detailed operating, investing, and financing cash flows with proper TTM calculations that sum all cash flow components over four quarters. TTM records are validated to ensure exactly four distinct quarters spanning 250-400 days for accurate trailing twelve-month cash flow analysis.
operationId: get_stocks_financials_v1_cash-flow-statements
parameters:
- description: 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](https://www.sec.gov/search-filings/cik-lookup).
in: query
name: cik
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: cik.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: cik.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: cik.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: cik.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: cik.lte
schema:
type: string
- description: The last date of the reporting period (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: period_end.lte
schema:
type: string
- description: 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'.
in: query
name: filing_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: filing_date.lte
schema:
type: string
- description: Filter for arrays that contain the value.
in: query
name: tickers
schema:
type: string
- description: Filter for arrays that contain all of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.all_of
schema:
type: string
- description: Filter for arrays that contain any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: tickers.any_of
schema:
type: string
- description: The fiscal year for the reporting period. Value must be a floating point number.
in: query
name: fiscal_year
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: fiscal_year.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_year.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: fiscal_year.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_year.lte
schema:
format: double
type: number
- description: The fiscal quarter number (1, 2, 3, or 4) for the reporting period. Value must be a floating point number.
in: query
name: fiscal_quarter
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: fiscal_quarter.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_quarter.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: fiscal_quarter.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: fiscal_quarter.lte
schema:
format: double
type: number
- description: 'The reporting period type. Possible values include: quarterly, annual, trailing_twelve_months.'
in: query
name: timeframe
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: timeframe.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: timeframe.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: timeframe.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: timeframe.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: timeframe.lte
schema:
type: string
- description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
in: query
name: limit
schema:
default: 100
maximum: 50000
minimum: 1
type: integer
- description: 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.
in: query
name: sort
schema:
default: period_end.asc
type: string
responses:
'200':
content:
application/json:
example:
request_id: d6d389ca03a0450d93c4ecb13ff26dae
results:
- cash_from_operating_activities_continuing_operations: 27867000000
change_in_cash_and_equivalents: 8107000000
change_in_other_operating_assets_and_liabilities_net: -2034000000
cik: 0000320193
depreciation_depletion_and_amortization: 2830000000
dividends: -3945000000
filing_date: '2025-08-01'
fiscal_quarter: 3
fiscal_year: 2025
long_term_debt_issuances_repayments: -1192000000
net_cash_from_financing_activities: -24833000000
net_cash_from_financing_activities_continuing_operations: -24833000000
net_cash_from_investing_activities: 5073000000
net_cash_from_investing_activities_continuing_operations: 5073000000
net_cash_from_operating_activities: 27867000000
net_income: 23434000000
other_financing_activities: -23599000000
other_investing_activities: 8535000000
other_operating_activities: 3637000000
period_end: '2025-06-28'
purchase_of_property_plant_and_equipment: -3462000000
short_term_debt_issuances_repayments: 3903000000
tickers:
- AAPL
timeframe: quarterly
status: OK
schema:
properties:
next_url:
description: If presen
# --- truncated at 32 KB (104 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-financials-api-openapi.yml