How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Twelve Data Fundamentals API

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

Twelve Data Fundamentals API is one of 15 APIs that Twelve Data publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Fundamentals. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 20 operations across 20 paths, and defines 118 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.twelvedata.com, https://api.twelvedata.com/.

20 operations 20 paths 118 schemas 20 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.twelvedata.com
Authentication
API Key, API Key, API Key, API Key
Resource Areas
1

Authentication & Security 4

Twelve Data Fundamentals API declares 4 security schemes for authenticating requests. An API key is passed in the query as apikey (apikeyQuery). An API key is passed in the header as Authorization (apikeyHeader). An API key is passed in the header as Authorization (authorizationHeader). An API key is passed in the query as apikey (queryParameter).

  • apikeyQuery — API key supplied as the apikey query parameter.
  • apikeyHeader — API key supplied as Authorization: apikey .
  • authorizationHeader — Enter the token with the apikey prefix, e.g. "apikey abcde12345".

Paths & Operations 20

Across 20 paths, the API surfaces 20 operations — 20 GET. Each is listed below with its method, path, parameters, and response codes.

Fundamentals 20

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

GET
/profile
Company profile
getProfile 2 params → 200
GET
/dividends
Dividends
getDividends 2 params → 200
GET
/earnings
Earnings
getEarnings 2 params → 200
GET
/income_statement
Income statement
getIncomeStatement 2 params → 200
GET
/balance_sheet
Balance sheet
getBalanceSheet 2 params → 200
GET
/cash_flow
Cash flow
getCashFlow 2 params → 200
GET
/statistics
Statistics
getStatistics 2 params → 200
GET
/balance_sheet/consolidated
Balance sheet consolidated
GetBalanceSheetConsolidated 11 params → 200400401403404414429500
GET
/cash_flow/consolidated
Cash flow consolidated
GetCashFlowConsolidated 11 params → 200400401403404414429500
GET
/dividends_calendar
Dividends calendar
GetDividendsCalendar 11 params → 200400401403404414429500
GET
/earnings_calendar
Earnings calendar
GetEarningsCalendar 8 params → 200400401403404414429500
GET
/income_statement/consolidated
Income statement consolidated
GetIncomeStatementConsolidated 11 params → 200400401403404414429500
GET
/ipo_calendar
IPO calendar
GetIpoCalendar 5 params → 200400401403404414429500
GET
/key_executives
Key executives
GetKeyExecutives 7 params → 200400401403404414429500
GET
/last_change/{endpoint}
Last changes
GetLastChanges 8 params → 200400401403404414429500
GET
/logo
Logo
GetLogo 4 params → 200400401403404414429500
GET
/market_cap
Market capitalization
GetMarketCap 11 params → 200400401403404414429500
GET
/press_releases
Press releases
PressReleasesListParameters 11 params → 200400401403404414429500
GET
/splits
Splits
GetSplits 10 params → 200400401403404414429500
GET
/splits_calendar
Splits calendar
GetSplitsCalendar 11 params → 200400401403404414429500

Schemas 118

The contract defines 118 schemas that model the data the API accepts and returns. The most detailed are CashFlowData_cash_flow_from_operating_activities (55 properties), AssetsInfo_non_current_assets (34 properties), CashFlowData_cash_flow_from_financing_activities (26 properties), CashFlowData_cash_flow_from_investing_activities (23 properties). Each schema is shown below with its type and property counts.

IncomeStatementItem
object
IncomeStatementItem represents a single income statement record
18 properties 2 required
GetDividends_200_response
object
2 properties 2 required
AssetsInfo_non_current_assets_goodwill_and_other_intangible_assets
object
Goodwill and other intangible assets information
3 properties
GetSplits_200_response
object
2 properties 2 required
IncomeStatementItem_depreciation
object
Depreciation information
1 property
IncomeStatementItem_depreciation_and_amortization
object
Depreciation and amortization information
6 properties
CashFlowData_direct_method_cash_flow
object
Direct method cash flow
8 properties
IncomeStatementItem_operating_income
object
Operating income information
5 properties
GetLogo_200_response
object
4 properties 1 required
ApiForbiddenErrorResponseBody
object
3 properties 3 required
IncomeStatementItem_net_income
object
Net income information
11 properties
AssetsInfo_current_assets_inventory
object
Inventory information
6 properties
DividendsCalendarItem
object
DividendsCalendarItem represents details of a dividend
5 properties 2 required
RangeSplitsEnum
string
IncomeStatementItem_gross_profit_cost_of_revenue
object
Cost of revenue information
3 properties
EarningsItem
object
6 properties 1 required
GetDividends_200_response_meta
object
Json object with request general information
6 properties
GetBalanceSheet_200_response_balance_sheet_inner_liabilities_non_current_liabilities
object
Non-current liabilities section
7 properties
EquityInfo_equity_adjustments
object
Equity adjustments information
6 properties
GetSplits_200_response_meta
object
Metadata about the instrument
6 properties 6 required
IncomeStatementItem_other_income_and_expenses
object
Other income and expenses information
14 properties
GetKeyExecutives_200_response_key_executives_inner
object
5 properties 2 required
GetLastChanges_200_response
object
2 properties 2 required
CashFlowData_cash_flow_from_investing_activities
object
Cash flow from investing activities
23 properties
GetBalanceSheetConsolidated_200_response
object
2 properties 1 required
GetBalanceSheet_200_response_balance_sheet_inner_shareholders_equity
object
Shareholders' equity section of the balance sheet
7 properties
AssetsInfo
object
AssetsInfo represents assets information in the balance sheet
4 properties
IncomeStatementItem_taxes
object
Taxes information
4 properties
GetBalanceSheet_200_response_balance_sheet_inner_liabilities_current_liabilities
object
Current liabilities section
8 properties
GetMarketCap_200_response_meta
object
Meta information about the company
6 properties 6 required
CashFlowData
object
CashFlowData represents cash flow data for a specific fiscal date
9 properties 1 required
CashFlowData_cash_flow_from_operating_activities
object
Cash flow from operating activities
55 properties
GetStatistics_200_response_statistics_stock_price_summary
object
Stock price summary of the company
6 properties
GetIpoCalendar_200_response_value_inner
object
9 properties 5 required
AssetsInfo_current_assets
object
Current assets information
15 properties
GetStatistics_200_response_statistics
object
Statistics of the company
5 properties
GetBalanceSheet_200_response
object
2 properties 2 required
GetBalanceSheet_200_response_balance_sheet_inner_assets_non_current_assets
object
Non-current assets section
13 properties
CashFlowStruct_investing_activities
object
Investing activities section
7 properties
TypeEnum
string
GetBalanceSheet_200_response_balance_sheet_inner_assets
object
Assets section of the balance sheet
3 properties
ApiInternalServerErrorResponseBody
object
3 properties 3 required
IncomeStatementItem_revenue
object
Revenue information
2 properties
CashFlowData_foreign_and_domestic_sales
object
Foreign and domestic sales
3 properties
GetStatistics_200_response_statistics_financials_income_statement
object
Income statement information
8 properties
ApiParameterTooLongErrorResponseBody
object
3 properties 3 required
IncomeStatementItem_special_income_charges
object
Special income charges information
1 property
GetBalanceSheet_200_response_balance_sheet_inner_liabilities
object
Liabilities section of the balance sheet
3 properties
EquityInfo
object
EquityInfo represents equity information
15 properties
FormatEnum
string
IncomeStatementItem_gross_profit
object
Gross profit information
2 properties
CashFlowStruct_financing_activities
object
Financing activities section
8 properties
GetEarningsCalendar_200_response
object
2 properties 2 required
ApiNotFoundErrorResponseBody
object
3 properties 3 required
LastChangeResponseItem
object
3 properties 3 required
GetLogo_200_response_meta
object
Meta information about the instrument
2 properties 1 required
GetLastChanges_200_response_pagination
object
Pagination information
2 properties 2 required
AssetsInfo_liabilities_non_current_liabilities_long_term_debt_and_capital_lease_obligation
object
Long term debt and capital lease obligation information
3 properties
GetStatistics_200_response
object
2 properties 2 required
GetBalanceSheet_200_response_balance_sheet_inner
object
5 properties 1 required
IncomeStatementItem_earnings_per_share
object
Earnings per share information
22 properties
GetStatistics_200_response_statistics_financials_cash_flow
object
Cash flow information
2 properties
GetStatistics_200_response_meta
object
Json object with request general information
6 properties 6 required
CashFlowData_cash_flow_from_financing_activities
object
Cash flow from financing activities
26 properties
GetStatistics_200_response_statistics_stock_statistics
object
Stock statistics of the company
9 properties
AssetsInfo_liabilities
object
Liabilities information
4 properties
GetStatistics_200_response_statistics_financials_balance_sheet
object
Balance sheet information
6 properties
IncomeStatementBlock_operating_expense
object
Operating expense details
3 properties
PressRelease
object
6 properties 4 required
GetEarnings_200_response
object
3 properties 3 required
CashFlowData_cash_position
object
Cash position
6 properties
IncomeStatementItem_ebitda
object
EBITDA information
3 properties
IncomeStatementItem_expenses
object
Expenses information
12 properties
ApiTooManyRequestsErrorResponseBody
object
3 properties 3 required
CashFlowStruct
object
10 properties 1 required
CashFlowStruct_operating_activities
object
Operating activities section
9 properties
SplitsCalendarResponseItem
object
List of stock splits
8 properties 5 required
IncomeStatementItem_pretax_income
object
Pretax income information
1 property
GetStatistics_200_response_statistics_financials
object
Financial information of the company
10 properties
GetMarketCap_200_response
object
2 properties 2 required
AssetsInfo_liabilities_non_current_liabilities
object
Non-current liabilities information
15 properties
AssetsInfo_liabilities_current_liabilities
object
Current liabilities information
17 properties
GetDividends_200_response_dividends_inner
object
2 properties 2 required
GetIncomeStatementConsolidated_200_response
object
2 properties
AssetsInfo_current_assets_receivables
object
Receivables information
11 properties
IncomeStatementItem_dividends_and_shares
object
Dividends and shares information
5 properties
IncomeStatementItem_interest_income_and_expense
object
Interest income and expense information
6 properties
GetCashFlow_200_response
object
2 properties 2 required
EndpointEnum
string
GetIncomeStatement_200_response_meta
object
Meta information about the instrument
7 properties 7 required
GetStatistics_200_response_statistics_dividends_and_splits
object
Dividends and splits information of the company
11 properties
AssetsInfo_non_current_assets
object
Non-current assets information
34 properties
GetProfile_200_response
object
18 properties 4 required
GetBalanceSheet_200_response_meta
object
Metadata about the balance sheet
7 properties 7 required
EquityInfo_capital_stock
object
Capital stock information
14 properties
PeriodEarningsEnum
string
GetKeyExecutives_200_response
object
2 properties 1 required
CashFlowData_supplemental_data
object
Supplemental data
2 properties
IncomeStatementItem_unusual_items
object
Unusual items information
2 properties
BalanceSheetConsolidatedItem
object
Balance sheet for a specific fiscal date
2 properties 1 required
PeriodEnum
string
GetSplits_200_response_splits_inner
object
5 properties 5 required
IncomeStatementBlock_non_operating_interest
object
Non-operating interest details
2 properties
GetBalanceSheet_200_response_balance_sheet_inner_assets_current_assets
object
Current assets section
13 properties
GetCashFlowConsolidated_200_response
object
2 properties 1 required
AssetsInfo_liabilities_current_liabilities_payables_and_accrued_expenses
object
Payables and accrued expenses information
10 properties
GetEarningsCalendar_200_response_earnings_value_inner
object
11 properties
RangeEnum
string
PressReleasesListParameters_200_response
object
2 properties 2 required
GetIncomeStatement_200_response
object
2 properties 1 required
ApiBadRequestErrorResponseBody
object
3 properties 3 required
GetCashFlow_200_response_meta
object
Meta information about the response
7 properties 7 required
IncomeStatementBlock
object
22 properties 1 required
GetMarketCap_200_response_market_cap_inner
object
2 properties 2 required
GetKeyExecutives_200_response_meta
object
Meta information about the instrument
6 properties 6 required
GetStatistics_200_response_statistics_valuations_metrics
object
Valuation metrics of the company
9 properties
ApiUnauthorizedErrorResponseBody
object
3 properties 3 required
GetEarnings_200_response_meta
object
Metadata about the instrument
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

twelvedata-fundamentals-api-openapi.yml Raw ↑

Other APIs Twelve Data publishes across the network.

Twelve Data WebSocket Streaming API
Twelve Data Core Data API
Twelve Data Reference Data API
Twelve Data Technical Indicators API
Twelve Data Time Series API
Twelve Data Advanced API
Twelve Data Analysis API
Twelve Data Currencies API
Twelve Data Etfs API
Twelve Data Market Data API
Twelve Data Money Market Funds API
Twelve Data Mutual Funds API
Where this information came from

This is an independent, third-party profile of Twelve Data Fundamentals API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.