Income Statement API
Receive an API key immediately and have access to the income statement data right away.
Income Statements API - Features
Finnworlds Income Statements Database contains all financial items within a company income statement. By using the database or the Income Statement API, you will have access to the data on the figures in the income statements of the company of your choice and you will be able to examine records of these financial reports and the latest disclosed ones.
The income statement data is available quarterly and annually based on the way it has been reported by the company. You can use the data to plug it in formulas for financial ratios to perform a thorough company financial analysis or offer already-calculated financial ratios data as a business solution. You will reduce your workload without having to amass your own data and maintain your own database.
The API returns data in JSON format and pulls the data from the Finnworlds income statement databases.
Current Income Statements
We update the record of income statements in our database as soon as new financial reports are published, and make them accessible through the Finnworlds Income Statements API.
Historical Income Statements API
The company income statement data is available historically starting from the year of the IPO going forward. Historical data allows you to build a platform in which your clients may view averages, run growth analysis and monitor company income and financial indicator changes throughout the years. In order to pull the designated year’s or quarter’s income statement, simply use the “&Year=XXXX” and “&quarter=Y” parameters in the endpoint and get that year’s or quarter’s income statements.
Income Statement Guidance API
Disclosing its quarterly or annual guidance, a company reports the ability to forecast its performance for the upcoming quarter or year that ultimately leads to a sharp increase in investor attention. Income Statement Guidance API allows setting expectations, goals, forecasts of the overall expected growth and performance of companies by providing these guidances as they are disclosed by companies for each fiscal quarter or year ahead. Get data for the projected earnings, revenues and capital spendings of companies with a single API.
Code Examples for the Income Statement API
https://finnworlds.com/api/v1/incomestatements
?key=YOUR-KEY
&stock_ticker_symbol=aapl
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "347,155,000",
"operating_revenue": "347,155,000"
"cost_of_revenue": "204,804,000"
"gross_profit": "142,351,000"
"operating_expense": "42,413,000"
"operating_income": "99,938,000"
"net_non_operating_interest_income_expense": "345,000"
"other_income_expense": "577,000"
"pretax_income": "100,860,000"
"tax_provision": "14,058,000"
"net_income_common_stockholders": "86,802,000"
"diluted_ni_available_to_com_stockholders": "86,802,000",
"basic_eps": ""
"diluted_eps": ""
"basic_average_shares": ""
"diluted_average_shares": ""
"total_operating_income_as_reported": "99,938,000"
"total_expenses": "247,217,000"
"net_income_from_continuing_and_discontinued_operation": "86,802,000"
"normalized_income": "86,802,000"
"interest_income": "2,952,000"
"interest_expense": "2,607,000"
"net_interest_income": "345,000"
"ebit": "103,467,000"
"ebitda": "114,464,000"
"reconciled_cost_of_revenue": "204,804,000"
"reconciled_depreciation": "10,997,000",
"net_income_from_continuing_operation_net_minority_interest": "86,802,000"
"total_unusual_items_excluding_goodwill": "0"
"total_unusual_items": "0"
"normalized_ebitda": "114,464,000"
"tax_rate_for_calcs": "0"
"tax_effect_of_unusual_items": "0"
}
[
}
https://finnworlds.com/api/v1/incomestatements
?key=YOUR-KEY
§or=technology
&industry=consumer_electronics
&income_statement=total_revenue
&year=2021
{
"status": {
"message": "Success"
},
"results": [
{
"basics": {
"name": "Apple Inc",
"stock_ticker_symbol": "AAPL"
"isin_identifier": "US0378331005"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "347,155,000",
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "168,088,000",
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "96,814,000",
},
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "...",
}
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_revenue": "...",
},
}
[
}
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| analyst_name | Analyst name from who you want ratings |
| analyst_firm | Analyst firm from which you want ratings |
| analyst_return_rate | Minimum return rate of analysts you want output from. (removes analyst with worse returns) |
| analyst_success_rate | Minimum success rate of analysts you want output from. (removes analysts with worse success rate) |
| date_from | Used for getting historical ratings in a certain date range |
| date_to | Used for getting historical ratings in a certain date range |
View Income Statement Data Over the Years
Historical data plays a crucial role in doing analysis for potential investments and determining if a company stock is overvalued or undervalued compared to other stocks of companies in the same industry. The Company Income Statement API serves as a great tool for accessing a historical database from which you can retrieve company income statement data of a certain period in time, for example “between 2009-2020”. In this way, you can examine the performance and the growth (or even a decline) of a company over the years, from the very first report from the IPO to the last with all quarterly and annual statements included.With a single endpoint, you may view the changes one company or a whole sector of companies have gone through during specific periods of time. For example, historical data proves quite useful for the company and sector performance changes during the COVID-19 outbreak, economic crises or administrative changes occuring in companies.
Data and Sources of the Income Statement API
The data is collected from our data partners including EDGAR, companies themselves and many more. The data collection and maintenance meets the GAAP and SEC standards. Keep in mind that you can access the data via the Income Statements API any time and retrieve it from Finnworlds database.
The API returns data with fast response times around 0.3 ms depending on the data load you request in the endpoint, with servers that have an uptime rate at 99.5%.
The standardized JSON data is compatible to work with all major programming and scripting languages including Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala.
Formats to Download the Data
The income statement data is accessible in three main formats. In this way, Finnworlds fully addresses your needs for data delivery formats. Request your data format and get income statement data instantly. No matter the format of your choice, you obtain income statement data without any differences in the data transfer time. Please, contact support@finnworlds.com for notifying which data format you prefer. You can always change the data delivery format.
Developer Notes
A big advantage of using the Income Statements API is the retrieval of filtered and bulk data from Finnworlds database. Thus, you are able to get income statement data of a whole sector or industry in which companies operate, one particular company or multiple companies of your choice filtered on their stock ticker symbols. You can further filter the financial statements on their year, period (yearly, quarterly or both), and receive them together with the cash flow statements and balance sheets of the same period as well. Mix and match the filters for the exact statement data you are looking for, or pull bulk data for a more detailed analysis.
SDKs and Devkits
REST JSON and XML
Excel and CSV
Access Income Statements Now!
Set up your subscription and receive your API key in a minute! No further authorization required, simply choose your plan and start getting data with the automatically generated API key sent to your email address immediately. Benefit from the trial month advantages to fully test the data. Upgrade or cancel your plan anytime. Finnworlds APIs have the finance data you have been looking for! Get started with your finance project and focus on your business without having to worry about finding a data source to work with any longer!
Control the Data
/incomestatements&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT
stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT