Twelve Data Fundamentals API

Company profiles, statements, dividends, earnings, and analysis.

Operations 20

GET /profile Company profile #
GET /dividends Dividends #
GET /earnings Earnings #
GET /income_statement Income statement #
GET /balance_sheet Balance sheet #
GET /cash_flow Cash flow #
GET /statistics Statistics #
GET /balance_sheet/consolidated Balance sheet consolidated #
GET /cash_flow/consolidated Cash flow consolidated #
GET /dividends_calendar Dividends calendar #
GET /earnings_calendar Earnings calendar #
GET /income_statement/consolidated Income statement consolidated #
GET /ipo_calendar IPO calendar #
GET /key_executives Key executives #
GET /last_change/{endpoint} Last changes #
GET /market_cap Market capitalization #
GET /press_releases Press releases #
GET /splits Splits #
GET /splits_calendar Splits calendar #

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/twelvedata-fundamentals-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 email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twelvedata-fundamentals-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Twelvedata Fundamentals API
  version: '1.0'
  description: 'Operations tagged Fundamentals across 2 of this provider''s published API definitions: twelvedata-fundamentals-api-openapi.yml, twelvedata-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.twelvedata.com
  description: Twelve Data REST base URL
- url: https://api.twelvedata.com/
tags:
- name: Fundamentals
  description: Company profiles, statements, dividends, earnings, and analysis.
paths:
  /profile:
    get:
      operationId: getProfile
      tags:
      - Fundamentals
      summary: Company profile
      description: Returns the company profile (sector, industry, description, employees, and more).
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Company profile payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /dividends:
    get:
      operationId: getDividends
      tags:
      - Fundamentals
      summary: Dividends
      description: Returns the dividend history for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Dividends payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /earnings:
    get:
      operationId: getEarnings
      tags:
      - Fundamentals
      summary: Earnings
      description: Returns historical and upcoming earnings for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Earnings payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /income_statement:
    get:
      operationId: getIncomeStatement
      tags:
      - Fundamentals
      summary: Income statement
      description: Returns the income statement for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Income statement payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /balance_sheet:
    get:
      operationId: getBalanceSheet
      tags:
      - Fundamentals
      summary: Balance sheet
      description: Returns the balance sheet for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Balance sheet payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /cash_flow:
    get:
      operationId: getCashFlow
      tags:
      - Fundamentals
      summary: Cash flow
      description: Returns the cash flow statement for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Cash flow payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /statistics:
    get:
      operationId: getStatistics
      tags:
      - Fundamentals
      summary: Statistics
      description: Returns key valuation, profitability, and financial statistics for a company.
      parameters:
      - $ref: '#/components/parameters/symbol'
      - $ref: '#/components/parameters/apikeyParam'
      responses:
        '200':
          description: Statistics payload.
      security:
      - apikeyQuery: []
      - apikeyHeader: []
    servers:
    - url: https://api.twelvedata.com
      description: Twelve Data REST base URL
  /balance_sheet/consolidated:
    get:
      description: The balance sheet consolidated endpoint provides a detailed overview of a company's raw balance sheet, including a comprehensive summary of its assets, liabilities, and shareholders' equity. This endpoint is useful for retrieving financial data that reflects the overall financial position of a company, allowing users to access critical information about its financial health and structure.
      operationId: GetBalanceSheetConsolidated
      parameters:
      - description: 'Symbol ticker of instrument.

          For preferred stocks use dot(.) delimiter.

          E.g. `BRK.A` or `BRK.B` will be correct'
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
          x-required-group: symbol
        x-go-name: Symbol
        x-order: '10'
        x-required-group: symbol
        example: AAPL
      - description: Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
          x-order: '20'
          x-required-group: symbol
        x-go-name: Figi
        x-order: '20'
        x-required-group: symbol
        example: BBG000B9Y5X2
      - description: Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
          x-order: '30'
          x-required-group: symbol
        x-go-name: Isin
        x-order: '30'
        x-required-group: symbol
        example: US0378331005
      - description: The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
          x-order: '31'
          x-required-group: symbol
        x-go-name: Cusip
        x-order: '31'
        x-required-group: symbol
        example: '594918104'
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '40'
        x-go-name: Exchange
        x-order: '40'
        example: NASDAQ
      - description: Market Identifier Code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '50'
        x-go-name: MicCode
        x-order: '50'
        example: XNAS
      - description: Country where instrument is traded, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '60'
        x-go-name: Country
        x-order: '60'
        example: United States
      - description: The reporting period for the balance sheet data.
        in: query
        name: period
        schema:
          $ref: '#/components/schemas/PeriodEnum'
        x-go-name: Period
        x-order: '70'
      - description: 'Begin date for filtering items by fiscal date. Returns income statements with fiscal dates on or after this date.

          Format `2006-01-02`'
        in: query
        name: start_date
        schema:
          type: string
          x-go-name: StartDate
          x-order: '80'
        x-go-name: StartDate
        x-order: '80'
      - description: 'End date for filtering items by fiscal date. Returns income statements with fiscal dates on or before this date.

          Format `2006-01-02`'
        in: query
        name: end_date
        schema:
          type: string
          x-go-name: EndDate
          x-order: '90'
        x-go-name: EndDate
        x-order: '90'
      - description: Number of records in response
        in: query
        name: outputsize
        schema:
          default: 6
          format: int64
          type: integer
          x-go-name: OutputSize
          x-order: '100'
        x-go-name: OutputSize
        x-order: '100'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBalanceSheetConsolidated_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Balance sheet consolidated
      tags:
      - Fundamentals
      x-additional-notes: This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
      x-api-credits-cost: '100'
      x-api-credits-type: symbol
      x-group: Fundamentals
      x-order: '140'
      x-starting-plan: ultra,enterprise
      x-url-hash: balance-sheet-consolidated
      x-required:
        anyOf:
        - required:
          - symbol
          - figi
          - isin
          - cusip
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /cash_flow/consolidated:
    get:
      description: The cash flow consolidated endpoint provides raw data on a company's consolidated cash flow, including the net cash and cash equivalents moving in and out of the business. It returns information on operating, investing, and financing activities, helping users track liquidity and financial health over a specified period.
      operationId: GetCashFlowConsolidated
      parameters:
      - description: 'Symbol ticker of instrument.

          For preferred stocks use dot(.) delimiter.

          E.g. `BRK.A` or `BRK.B` will be correct'
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
          x-required-group: symbol
        x-go-name: Symbol
        x-order: '10'
        x-required-group: symbol
        example: AAPL
      - description: Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
          x-order: '20'
          x-required-group: symbol
        x-go-name: Figi
        x-order: '20'
        x-required-group: symbol
        example: BBG000B9Y5X2
      - description: Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
          x-order: '30'
          x-required-group: symbol
        x-go-name: Isin
        x-order: '30'
        x-required-group: symbol
        example: US0378331005
      - description: The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
          x-order: '31'
          x-required-group: symbol
        x-go-name: Cusip
        x-order: '31'
        x-required-group: symbol
        example: '594918104'
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '40'
        x-go-name: Exchange
        x-order: '40'
        example: NASDAQ
      - description: Market Identifier Code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '50'
        x-go-name: MicCode
        x-order: '50'
        example: XNAS
      - description: Country where instrument is traded, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '60'
        x-go-name: Country
        x-order: '60'
        example: United States
      - description: The reporting period for the cash flow statements
        in: query
        name: period
        schema:
          $ref: '#/components/schemas/PeriodEnum'
        x-go-name: Period
        x-order: '70'
      - description: 'Start date for filtering cash flow statements. Only cash flow statements with fiscal dates on or after this date will be included.

          Format `2006-01-02`'
        in: query
        name: start_date
        schema:
          type: string
          x-go-name: StartDate
          x-order: '80'
        x-go-name: StartDate
        x-order: '80'
        example: '2024-01-01'
      - description: 'End date for filtering cash flow statements. Only cash flow statements with fiscal dates on or before this date will be included.

          Format `2006-01-02`'
        in: query
        name: end_date
        schema:
          type: string
          x-go-name: EndDate
          x-order: '90'
        x-go-name: EndDate
        x-order: '90'
        example: '2024-12-31'
      - description: Number of records in response
        in: query
        name: outputsize
        schema:
          default: 6
          format: int64
          type: integer
          x-go-name: OutputSize
          x-order: '100'
        x-go-name: OutputSize
        x-order: '100'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCashFlowConsolidated_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Cash flow consolidated
      tags:
      - Fundamentals
      x-additional-notes: This API endpoint is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
      x-api-credits-cost: '100'
      x-api-credits-type: symbol
      x-group: Fundamentals
      x-order: '160'
      x-starting-plan: ultra,enterprise
      x-url-hash: cash-flow-consolidated
      x-required:
        anyOf:
        - required:
          - symbol
          - figi
          - isin
          - cusip
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /dividends_calendar:
    get:
      description: The dividends calendar endpoint provides a detailed schedule of upcoming and past dividend events for specified date ranges. By using the `start_date` and `end_date` parameters, users can retrieve a list of companies issuing dividends, including the ex-dividend date and dividend amount. This endpoint is ideal for tracking dividend payouts and planning investment strategies based on dividend schedules.
      operationId: GetDividendsCalendar
      parameters:
      - description: 'Symbol ticker of instrument. For preferred stocks use dot(.) delimiter.

          E.g. `BRK.A` or `BRK.B` will be correct'
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '1'
        x-go-name: Symbol
        x-order: '1'
        example: AAPL
      - description: Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
          x-order: '2'
        x-go-name: Figi
        x-order: '2'
        example: BBG000B9Y5X2
      - description: Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
          x-order: '3'
        x-go-name: Isin
        x-order: '3'
        example: US0378331005
      - description: The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
          x-order: '4'
        x-go-name: Cusip
        x-order: '4'
        example: '594918104'
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '10'
        x-go-name: Exchange
        x-order: '10'
        example: NASDAQ
      - description: Market Identifier Code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '20'
        x-go-name: MicCode
        x-order: '20'
        example: XNAS
      - description: Country where instrument is traded, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '30'
        x-go-name: Country
        x-order: '30'
        example: US
      - description: Start date for the dividends calendar query. Only dividends with ex-dates on or after this date will be returned. Format `2006-01-02`
        in: query
        name: start_date
        schema:
          type: string
          x-go-name: StartDate
          x-order: '40'
        x-go-name: StartDate
        x-order: '40'
        example: '2024-01-01'
      - description: End date for the dividends calendar query. Only dividends with ex-dates on or before this date will be returned. Format `2006-01-02`
        in: query
        name: end_date
        schema:
          type: string
          x-go-name: EndDate
          x-order: '50'
        x-go-name: EndDate
        x-order: '50'
        example: '2024-12-31'
      - description: 'Number of data points to retrieve.

          Supports values in the range from `1` to `500`.

          Default `100` when no date parameters are set, otherwise set to maximum'
        in: query
        name: outputsize
        schema:
          default: 100
          format: int64
          type: integer
          x-go-name: Outputsize
          x-order: '60'
        x-go-name: Outputsize
        x-order: '60'
      - description: Page number
        in: query
        name: page
        schema:
          default: 1
          format: int64
          type: integer
          x-go-name: Page
          x-order: '70'
        x-go-name: Page
        x-order: '70'
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/DividendsCalendarItem'
                type: array
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Dividends calendar
      tags:
      - Fundamentals
      x-api-credits-cost: '40'
      x-api-credits-type: symbol
      x-group: Fundamentals
      x-order: '40'
      x-starting-plan: grow,venture
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /earnings_calendar:
    get:
      description: The earnings calendar endpoint provides a schedule of company earnings announcements for a specified date range. By default, it returns earnings data for the current day. Users can customize the date range using the `start_date` and `end_date` parameters to retrieve earnings information for specific periods. This endpoint is useful for tracking upcoming earnings reports and planning around key financial announcements.
      operationId: GetEarningsCalendar
      parameters:
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '10'
        x-go-name: Exchange
        x-order: '10'
        example: NASDAQ
      - description: Market Identifier Code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '20'
        x-go-name: MicCode
        x-order: '20'
        example: XNAS
      - description: Country where instrument is traded, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '30'
        x-go-name: Country
        x-order: '30'
        example: United States
      - description: Value can be JSON or CSV
        in: query
        name: format
        schema:
          $ref: '#/components/schemas/FormatEnum'
        x-go-name: Format
        x-order: '40'
      - description: Specify the delimiter used when downloading the CSV file
        in: query
        name: delimiter
        schema:
          default: ;
          type: string
          x-go-name: Delimiter
          x-order: '50'
        x-go-name: Delimiter
        x-order: '50'
      - description: 'Can be used separately and together with end_date.

          Format `2006-01-02` or `2006-01-02T15:04:05`'
        in: query
        name: start_date
        schema:
          type: string
          x-go-name: StartDate
          x-order: '70'
        x-go-name: StartDate
        x-order: '70'
        example: '2024-04-01'
      - description: 'Can be used separately and together with start_date.

          Format `2006-01-02` or `2006-01-02T15:04:05`'
        in: query
        name: end_date
        schema:
          type: string
          x-go-name: EndDate
          x-order: '80'
        x-go-name: EndDate
        x-order: '80'
        example: '2024-04-30'
      - description: 'Specifies the number of decimal places for floating values.

          Should be in range [0,11] inclusive'
        in: query
        name: dp
        schema:
          default: 2
          format: int64
          type: integer
          x-go-name: DecimalPlaces
          x-order: '60'
        x-go-name: DecimalPlaces
        x-order: '60'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEarningsCalendar_200_response'
          description: ''
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiBadRequestErrorResponseBody'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUnauthorizedErrorResponseBody'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiForbiddenErrorResponseBody'
          description: ''
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiNotFoundErrorResponseBody'
          description: ''
        '414':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiParameterTooLongErrorResponseBody'
          description: ''
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTooManyRequestsErrorResponseBody'
          description: ''
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiInternalServerErrorResponseBody'
          description: ''
      summary: Earnings calendar
      tags:
      - Fundamentals
      x-api-credits-cost: '40'
      x-api-credits-type: request
      x-group: Fundamentals
      x-order: '80'
      x-starting-plan: grow,venture
      security:
      - authorizationHeader:
        - '[]'
      - queryParameter:
        - '[]'
    servers:
    - url: https://api.twelvedata.com/
  /income_statement/consolidated:
    get:
      description: The income statement consolidated endpoint provides a company's raw income statement, detailing revenue, expenses, and net income for specified periods, either annually or quarterly. This data is essential for evaluating a company's financial performance over time, allowing users to access comprehensive financial results in a structured format.
      operationId: GetIncomeStatementConsolidated
      parameters:
      - description: 'Symbol ticker of instrument.

          For preferred stocks use dot(.) delimiter.

          E.g. `BRK.A` or `BRK.B` will be correct'
        in: query
        name: symbol
        schema:
          type: string
          x-go-name: Symbol
          x-order: '10'
          x-required-group: symbol
        x-go-name: Symbol
        x-order: '10'
        x-required-group: symbol
        example: AAPL
      - description: Filter by financial instrument global identifier (FIGI). This parameter is available on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.
        in: query
        name: figi
        schema:
          type: string
          x-go-name: Figi
          x-order: '20'
          x-required-group: symbol
        x-go-name: Figi
        x-order: '20'
        x-required-group: symbol
        example: BBG000B9Y5X2
      - description: Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: isin
        schema:
          type: string
          x-go-name: Isin
          x-order: '30'
          x-required-group: symbol
        x-go-name: Isin
        x-order: '30'
        x-required-group: symbol
        example: US0378331005
      - description: The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section
        in: query
        name: cusip
        schema:
          type: string
          x-go-name: Cusip
          x-order: '31'
          x-required-group: symbol
        x-go-name: Cusip
        x-order: '31'
        x-required-group: symbol
        example: '594918104'
      - description: Exchange where instrument is traded
        in: query
        name: exchange
        schema:
          type: string
          x-go-name: Exchange
          x-order: '40'
        x-go-name: Exchange
        x-order: '40'
        example: NASDAQ
      - description: Market Identifier Code (MIC) under ISO 10383 standard
        in: query
        name: mic_code
        schema:
          type: string
          x-go-name: MicCode
          x-order: '50'
        x-go-name: MicCode
        x-order: '50'
        example: XNAS
      - description: Country where instrument is traded, e.g., `United States` or `US`
        in: query
        name: country
        schema:
          type: string
          x-go-name: Country
          x-order: '60'
        x-go-name: Country
        x-order: '60'
        example: United States
      - description: The reporting period for the income statement data
        in: query
        name: period
        schema:
          $ref: '#/components/schemas/PeriodEnum'
        x-go-name: Period
        x-order: '70'
      - description: 'Begin date for filtering income statements by fiscal date.

          Returns income statements with fiscal dates on or after this date.

          Format `2006-01-02`'
        in: query
        name: start_date
        schema:
          type: string
          x-go-name: StartDate
          x-order: '80'
        x-go-name: StartDate
        x-order: '80'
        exampl

# --- truncated at 32 KB (276 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twelvedata/refs/heads/main/openapi/twelvedata-fundamentals-api-openapi.yml