Balance Sheet API
Receive an API key immediately and have access to the balance sheet data right away.
Balance Sheet API - Features
The Balance Sheet API gives access to a complete database of company balance sheets reported by companies to the SEC. The balance sheets in the database are stored historically starting from the first reports with the IPO going forward and updated as new balance sheets are added. You can get data on companies’ assets, liabilities and shareholders’ equity. In this way, you will easily do analyses on the capital structure of the chosen company or you can build a website (or an app) on which such data will be displayed for your clients. You can get information on what a company owns and owes along with shareholder investments or you can also obtain bulk balance sheet data on multiple companies in an industry and compare their financials.
The balance sheet database contains the following financial items: cash, receivables, inventory, prepaid expenses, total current and long-term assets and liabilities of the company as well as data on the shareholders. By getting an API key, you will have continuous access to the balance sheet database without having to create and maintain one yourself.
Current Balance Sheet Data
We update the balance sheet data in our database as soon as the new financial reports are published making them accessible through the API.
Balance Sheet Guidance API
The Balance Sheet Guidance API enables you to get the official company guidance disclosed within the balance sheets that reveals planned commercial activities and expected gains of the company for the fiscal quarter or year ahead. This data allows forecasting the growth and the income of a company and tracking how these two items have changed over time, especially when comparing to previous figures.
Access the Balance Sheet Guidance Database without having to collect this data yourself for every company and perform in-depth analyses to find out the best stocks to invest in. Offer your clients an all-in-one platform on which they can both view complete balance sheet data and reach official company guidance by integrating the Balance Sheet Guidance API into your website or app.
Historical Balance Sheet API
Through the Historical Balance Sheet API, you get historical balance sheet data as well starting from the IPO year of the companies you request. The data is automatically updated once companies publish their latest balance sheets for the quarter or the year, which makes you able to compare figures from the historical and current company financial conditions. Moreover, you can easily create charts and graphs by obtaining the historical balance sheet data from Finnworlds database, and elevate your business solutions. The work process with the Balance Sheet API and database is straightforward. In order to view balance sheet data of a specific year or quarter, simply add the “&Year=XXXX” and “&quarter=Y” parameters in the endpoint and collect data of that exact year or quarter. The data filtering on the quarter and year is optional, so you can always filter on consecutive years.
Code Examples for the Balance Sheet API
https://finnworlds.com/api/v1/balancesheets
?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_assets": "323,888,000",
"total_liabilities_net_minority_interest": "258,549,000"
"total_equity_gross_minority_interest": "65,339,000"
"total_capitalization": "164,006,000"
"common_stock_equity": "65,339,000"
"net_tangible_assets": "65,339,000"
"working_capital": "38,321,000"
"invested_capital": "177,775,000"
"tangible_book_value": "65,339,000"
"total_debt": "112,436,000"
"net_debt": "74,420,000"
"share_issued": "16,976,763",
"ordinary_shares_number": "16,976,763"
}
[
}
https://finnworlds.com/api/v1/balancesheets
?key=YOUR-KEY
§or=technology
&industry=consumer_electronics
&income_statement=total_assets
&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_assets": "323,888,000",
},
"basics": {
"name": "Microsoft Corporation",
"stock_ticker_symbol": "MSFT"
"isin_identifier": "US5949181045"
"exchange": "nasdaq"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "333,779,000",
},
"basics": {
"name": "Dell Technologies Inc",
"stock_ticker_symbol": "DELL"
"isin_identifier": "US24703L2025"
"exchange": "NYSE"
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "123,415,000",
},
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "...",
}
"basics": {
"name": "...",
"stock_ticker_symbol": "..."
"isin_identifier": "..."
"exchange": "..."
"industry": "technology"
"sector": "consumer electronics"
},
"output": {
"total_assets": "...",
},
}
[
}
| Objects | Description |
| stock_ticker_symbol | Stock for which you want output |
| sector | Sector this security is classified under |
| industry | Industries this security is classified under |
| balance_sheet | If you want to highlight specific components of the balance sheet (assets, liabilities, …) See response objects. |
| format | Quarterly results or Yearly results |
| year | Year for which you want results |
| quarter | Quarter for which you want results |
Compare Financial Company Data Over the Years
The API provides balance sheet data from the very beginning, the IPO year. This means that through the API you track the growth in the total assets as well as in the liabilities and shareholders’ equities of the company starting from the very first balance sheet report throughout the years.
Data and Sources of the Balance Sheets API
Within the Balance Sheets database, the data is collected from multiple sources including data partners in various sectors, SEC and directly from companies when possible. The data collection and maintenance meets the SEC standards. Keep in mind that you can access the data via the Balance Sheet API any time and retrieve it from Finnworlds database. The API for balance sheet data can be integrated for both personal and commercial projects. Feel free to contact us for assistance about the project you have in mind.
Formats to Download the Data
The balance sheet 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 balance sheet data instantly. No matter the format of your choice, you obtain balance sheet 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
The balance sheet data is stored in well-maintained servers that have an uptime rate of 99.5%. API response times may differ depending on the load of the data requested in one API call, but has an average of around 0.3 ms per API call. The API addresses all developers and businesses of all scales that work with different programming and scripting languages. It is possible to use the API to pull balance sheet data based on an individual company by entering its stock ticker symbol or a whole sector or industry of companies and view their total assets company by company. You can determine the format (quarterly, annually or both), the desired quarter and year of the balance sheet by using the filters.
SDKs and Devkits
REST JSON and XML
Excel and CSV
Balance Sheet API – Get Started Right Away!
Access the company balance sheet data right away by creating an API subscription in a few easy steps. Get your automatically generated API key into your e-mail immediately and begin pulling data with the Company Balance Sheet API. Access the data for as long as your subscription is active. Upgrade your plan easily as you expand your project and need a higher monthly API call limit. Cancel anytime. View all options and get your API key by clicking the button on the top!
Control the Data
/balancesheets&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT
stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT