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.

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.

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.

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.

Check Developer Documentation

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
        &sector=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": "...",
            },
        }
    [
}
				
			

ObjectsDescription
stock_ticker_symbolStock for which you want output
analyst_nameAnalyst name from who you want ratings
analyst_firmAnalyst firm from which you want ratings
analyst_return_rateMinimum return rate of analysts you want output from. (removes analyst with worse returns)
analyst_success_rateMinimum success rate of analysts you want output from. (removes analysts with worse success rate)
date_fromUsed for getting historical ratings in a certain date range
date_toUsed 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.

Try The Data

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.

Contact us
Excel and CSV
If you choose this data format, you will access income statement data through database downloads formatted as either Excel or CSV files.
E-mail link
If you choose this data format, you will receive an email containing a link through which you can download income statement data .
Pdf Report
If you choose this data format, you will get income statement data in a downloadable PDF report.

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

Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala

REST JSON and XML

Filter the data using any of the company indicators. Data output can be requested in REST JSON format or XML format

Excel and CSV

In case you do not want the data through our API, request it in Excel or CSV format.

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