MetricDuck Financial Statements API
The Financial Statements API from MetricDuck — 3 operation(s) for financial statements.
The Financial Statements API from MetricDuck — 3 operation(s) for financial statements.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-financial-statements-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Metric Duck Financial Statements API
description: 'SEC filing data API: equity fundamentals updated daily from SEC EDGAR'
version: 2.0.0
tags:
- name: Financial Statements
paths:
/api/v1/companies/{ticker}/income-statement:
get:
tags:
- Financial Statements
summary: Get income statement data
description: 'Returns quarterly, annual, or TTM income statement line items for a company.
Includes revenue, costs, gross profit, operating income, net income, and EPS data.
Optional segment-level breakdown available for companies with multiple business segments.
**Data Source:** SEC EDGAR (10-K, 10-Q filings)
**Data Freshness:** Updated within 24 hours of SEC filing
**Caching:** Responses cached 1 hour'
operationId: get_income_statement_api_v1_companies__ticker__income_statement_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
title: Ticker
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
- name: period
in: query
required: false
schema:
type: string
pattern: ^(quarterly|annual|ttm)$
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
default: quarterly
title: Period
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
- name: years
in: query
required: false
schema:
type: integer
maximum: 10
minimum: 1
description: Number of years of historical data to return (1-10)
default: 5
title: Years
description: Number of years of historical data to return (1-10)
- name: include_segment_hierarchy
in: query
required: false
schema:
type: boolean
description: Include hierarchical business segment breakdown (if available)
default: false
title: Include Segment Hierarchy
description: Include hierarchical business segment breakdown (if available)
- name: vantage_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
title: Vantage Date
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
- name: signed
in: query
required: false
schema:
type: boolean
description: Apply statement-faithful presentation signs (default false → positive magnitudes). When true, income-statement deductions (interest_expense, gain_loss_invests) are returned negative as they appear on the filed statement.
default: false
title: Signed
description: Apply statement-faithful presentation signs (default false → positive magnitudes). When true, income-statement deductions (interest_expense, gain_loss_invests) are returned negative as they appear on the filed statement.
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
responses:
'200':
description: Success - Returns list of income statement periods
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/IncomeStatementItem'
title: Response 200 Get Income Statement Api V1 Companies Ticker Income Statement Get
'400':
description: Bad Request - Invalid parameters (check ticker format, period, or years)
'404':
description: Not Found - Ticker not found or no data available for requested period
'429':
description: Too Many Requests - Rate limit exceeded (see Retry-After header)
'500':
description: Internal Server Error - Database or service error
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/companies/{ticker}/balance-sheet:
get:
tags:
- Financial Statements
summary: Get balance sheet data
description: 'Returns quarterly, annual, or TTM balance sheet line items for a company.
Includes assets, liabilities, equity, debt metrics, and working capital data.
Point-in-time snapshot metrics showing financial position as of period end.
**Data Source:** SEC EDGAR (10-K, 10-Q filings)
**Data Freshness:** Updated within 24 hours of SEC filing
**Caching:** Responses cached 1 hour'
operationId: get_balance_sheet_api_v1_companies__ticker__balance_sheet_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
title: Ticker
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
- name: period
in: query
required: false
schema:
type: string
pattern: ^(quarterly|annual|ttm)$
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
default: quarterly
title: Period
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
- name: years
in: query
required: false
schema:
type: integer
maximum: 10
minimum: 1
description: Number of years of historical data to return (1-10)
default: 5
title: Years
description: Number of years of historical data to return (1-10)
- name: vantage_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
title: Vantage Date
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
responses:
'200':
description: Success - Returns list of balance sheet periods
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BalanceSheetItem'
title: Response 200 Get Balance Sheet Api V1 Companies Ticker Balance Sheet Get
'400':
description: Bad Request - Invalid parameters (check ticker format, period, or years)
'404':
description: Not Found - Ticker not found or no data available for requested period
'429':
description: Too Many Requests - Rate limit exceeded (see Retry-After header)
'500':
description: Internal Server Error - Database or service error
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/companies/{ticker}/cash-flow:
get:
tags:
- Financial Statements
summary: Get cash flow statement data
description: 'Returns quarterly, annual, or TTM cash flow statement line items for a company.
Includes operating, investing, and financing cash flows, plus free cash flow calculations.
Period-based cumulative metrics showing cash generation and allocation.
**Data Source:** SEC EDGAR (10-K, 10-Q filings)
**Data Freshness:** Updated within 24 hours of SEC filing
**Caching:** Responses cached 1 hour'
operationId: get_cash_flow_statement_api_v1_companies__ticker__cash_flow_get
security:
- HTTPBearer: []
- APIKeyHeader: []
parameters:
- name: ticker
in: path
required: true
schema:
type: string
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
title: Ticker
description: Company ticker symbol (e.g., 'AAPL', 'MSFT')
- name: period
in: query
required: false
schema:
type: string
pattern: ^(quarterly|annual|ttm)$
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
default: quarterly
title: Period
description: 'Aggregation level: ''quarterly'', ''annual'', or ''ttm'' (trailing twelve months)'
- name: years
in: query
required: false
schema:
type: integer
maximum: 10
minimum: 1
description: Number of years of historical data to return (1-10)
default: 5
title: Years
description: Number of years of historical data to return (1-10)
- name: vantage_date
in: query
required: false
schema:
anyOf:
- type: string
format: date
- type: 'null'
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
title: Vantage Date
description: 'As-of vantage (YYYY-MM-DD): bounds which periods are visible (filed on or before this date) and which filing is cited. It does NOT reconstruct values: they are the latest filed, so a later restatement or recast (including a later 10-K''s comparative columns) is served under the vantage-era citation. revised_after_vantage flags only a later amendment of the period''s own filing. For values as known at the vantage, query XBRL facts pinned to the latest filing on or before it that reports the period; XBRL facts with period_history give values as originally filed. Omit for the latest.'
- name: signed
in: query
required: false
schema:
type: boolean
description: Apply statement-faithful presentation signs (default false → positive magnitudes). When true, cash outflows (capex, dividends_paid, stock_repurch) and operating asset-increases (chg_accs_recvb, chg_inventory, oper_other_cf) are returned negative as on the filed statement; already-signed nets (net_cf_inv/fin, chg_working_cap, defer_inc_taxes_cf) pass through unchanged. Use this for cash-flow reconstruction / DCF.
default: false
title: Signed
description: Apply statement-faithful presentation signs (default false → positive magnitudes). When true, cash outflows (capex, dividends_paid, stock_repurch) and operating asset-increases (chg_accs_recvb, chg_inventory, oper_other_cf) are returned negative as on the filed statement; already-signed nets (net_cf_inv/fin, chg_working_cap, defer_inc_taxes_cf) pass through unchanged. Use this for cash-flow reconstruction / DCF.
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Api Key
responses:
'200':
description: Success - Returns list of cash flow periods
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CashFlowItem'
title: Response 200 Get Cash Flow Statement Api V1 Companies Ticker Cash Flow Get
'400':
description: Bad Request - Invalid parameters (check ticker format, period, or years)
'404':
description: Not Found - Ticker not found or no data available for requested period
'429':
description: Too Many Requests - Rate limit exceeded (see Retry-After header)
'500':
description: Internal Server Error - Database or service error
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
CashFlowItem:
properties:
primary_document:
anyOf:
- type: string
- type: 'null'
title: Primary Document
cik:
type: string
title: Cik
accession_number:
anyOf:
- type: string
- type: 'null'
title: Accession Number
date:
type: string
title: Date
symbol:
type: string
title: Symbol
filing_date:
anyOf:
- type: string
format: date
- type: 'null'
title: Filing Date
fiscal_year:
type: integer
title: Fiscal Year
period:
type: string
title: Period
industry:
anyOf:
- type: string
- type: 'null'
title: Industry
original_accession_number:
anyOf:
- type: string
- type: 'null'
title: Original Accession Number
revised_after_vantage:
type: boolean
title: Revised After Vantage
default: false
source_attribution:
anyOf:
- additionalProperties:
items:
type: string
type: array
type: object
- type: 'null'
title: Source Attribution
metric_basis:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Metric Basis
reporting_currency:
type: string
title: Reporting Currency
default: USD
metrics:
additionalProperties:
anyOf:
- type: number
- type: 'null'
type: object
title: Metrics
default: {}
sec_document_url:
anyOf:
- type: string
- type: 'null'
title: Sec Document Url
readOnly: true
sec_filing_url:
anyOf:
- type: string
- type: 'null'
title: Sec Filing Url
description: "Generate SEC EDGAR filing index URL.\n\nReturns:\n URL string if accession_number exists, None otherwise"
readOnly: true
type: object
required:
- cik
- date
- symbol
- fiscal_year
- period
- sec_document_url
- sec_filing_url
title: CashFlowItem
description: Individual cash flow statement period data
IncomeStatementItem:
properties:
primary_document:
anyOf:
- type: string
- type: 'null'
title: Primary Document
cik:
type: string
title: Cik
accession_number:
anyOf:
- type: string
- type: 'null'
title: Accession Number
date:
type: string
title: Date
symbol:
type: string
title: Symbol
filing_date:
anyOf:
- type: string
format: date
- type: 'null'
title: Filing Date
fiscal_year:
type: integer
title: Fiscal Year
period:
type: string
title: Period
industry:
anyOf:
- type: string
- type: 'null'
title: Industry
original_accession_number:
anyOf:
- type: string
- type: 'null'
title: Original Accession Number
revised_after_vantage:
type: boolean
title: Revised After Vantage
default: false
source_attribution:
anyOf:
- additionalProperties:
items:
type: string
type: array
type: object
- type: 'null'
title: Source Attribution
metric_basis:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Metric Basis
reporting_currency:
type: string
title: Reporting Currency
default: USD
metrics:
additionalProperties:
anyOf:
- type: number
- type: 'null'
type: object
title: Metrics
default: {}
sec_document_url:
anyOf:
- type: string
- type: 'null'
title: Sec Document Url
readOnly: true
sec_filing_url:
anyOf:
- type: string
- type: 'null'
title: Sec Filing Url
description: "Generate SEC EDGAR filing index URL.\n\nReturns:\n URL string if accession_number exists, None otherwise"
readOnly: true
type: object
required:
- cik
- date
- symbol
- fiscal_year
- period
- sec_document_url
- sec_filing_url
title: IncomeStatementItem
description: Individual income statement period data
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
BalanceSheetItem:
properties:
primary_document:
anyOf:
- type: string
- type: 'null'
title: Primary Document
cik:
type: string
title: Cik
accession_number:
anyOf:
- type: string
- type: 'null'
title: Accession Number
date:
type: string
title: Date
symbol:
type: string
title: Symbol
filing_date:
anyOf:
- type: string
format: date
- type: 'null'
title: Filing Date
fiscal_year:
type: integer
title: Fiscal Year
period:
type: string
title: Period
industry:
anyOf:
- type: string
- type: 'null'
title: Industry
original_accession_number:
anyOf:
- type: string
- type: 'null'
title: Original Accession Number
revised_after_vantage:
type: boolean
title: Revised After Vantage
default: false
source_attribution:
anyOf:
- additionalProperties:
items:
type: string
type: array
type: object
- type: 'null'
title: Source Attribution
metric_basis:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Metric Basis
reporting_currency:
type: string
title: Reporting Currency
default: USD
metrics:
additionalProperties:
anyOf:
- type: number
- type: 'null'
type: object
title: Metrics
default: {}
sec_document_url:
anyOf:
- type: string
- type: 'null'
title: Sec Document Url
readOnly: true
sec_filing_url:
anyOf:
- type: string
- type: 'null'
title: Sec Filing Url
description: "Generate SEC EDGAR filing index URL.\n\nReturns:\n URL string if accession_number exists, None otherwise"
readOnly: true
type: object
required:
- cik
- date
- symbol
- fiscal_year
- period
- sec_document_url
- sec_filing_url
title: BalanceSheetItem
description: Individual balance sheet period data
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key