MetricDuck Financial Statements API

The Financial Statements API from MetricDuck — 3 operation(s) for financial statements.

GitHub OpenAPI

Operations 3

GET /api/v1/companies/{ticker}/income-statement Get income statement data #
GET /api/v1/companies/{ticker}/balance-sheet Get balance sheet data #
GET /api/v1/companies/{ticker}/cash-flow Get cash flow statement data #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/metricduck-com:metricduck-com-financial-statements-api"
All apis
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.

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. 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 Specification

metricduck-com-financial-statements-api-openapi.yml Raw ↑
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