Complete Company Financial Statements Data Via API
Tags: financialdata, api, finance, companydata
Published: 2024-02-02 15:43:24

It’s good to be back! Being developers with a background in finance, we have [built this Financial Statements API](https://finnworlds.com/financial-data/company-financial-statement-reports-api/) for our fellow developers. I will provide sample outputs that I think you might find useful 💡

I want to inspire ideas on how you can integrate financial statement data into your project. With the rise of personal finance and investment tracking apps, **financial statement API is a useful tool to run cash flow, balance sheet and income statement data behind these**. Moreover, historical financial statement data can be key in **financial analysis** and **business accounting**. People like to keep an eye out for new entries and the performance of current investments – which is dependent on **data**. So, the right API can just be why they will pick yours over your competitors.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/eeg4wv8i9c8gcv6qkli0.jpeg)

## Cash Flow Data, Balance Sheet Data and Income Statements Data Under One API

This API covers all information points in 3 key company financial statements which are **cash flows, balance sheets and income statements**. This is definitely time and cost-friendly considering the alternative of separate research for API providers.

I will start with example outputs for each report type so you can see the data points they include. All accessible with the same personal API key.

---------

### Cash Flow API Output

I'm using a simple, filter-free request for META:

```
https://api.finnworlds.com/api/v1/cashflows?key=APIKEY&ticker=META

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "ticker": "META",
            "period": "quarterly"
        },
        "output": {
            "cash_flow": [
                {
                    "date": "2023-09-30",
                    "asset_impairment_charge": "340000000",
                    "beginning_cash_position": "29804000000",
                    "capital_expenditure": "-6543000000",
                    "cash_flow_from_continuing_financing_activities": "-5875000000",
                    "cash_flow_from_continuing_investing_activities": "-6077000000",
                    "cash_flow_from_continuing_operating_activities": "20402000000",
                    "change_in_account_payable": "612000000",
                    "change_in_accrued_expense": "78000000",
                    "change_in_other_current_assets": "-36000000",
                    "change_in_other_current_liabilities": "-72000000",
                    "change_in_payable": "621000000",
                    "change_in_payables_and_accrued_expense": "699000000",
                    "change_in_prepaid_assets": "-908000000",
                    "change_in_receivables": "-678000000",
                    "change_in_working_capital": "-995000000",
                    "changes_in_account_receivables": "-678000000",
                    "changes_in_cash": "8450000000",
                    "common_stock_payments": "-3569000000",
                    "deferred_income_tax": "3049000000",
                    "deferred_tax": "3049000000",
                    "depreciation_amortization_depletion": "2859000000",
                    "depreciation_and_amortization": "2859000000",
                    "effect_of_exchange_rate_changes": "-354000000",
                    "end_cash_position": "37900000000",
                    "financing_cash_flow": "-5875000000",
                    "free_cash_flow": "13859000000",
                    "income_tax_paid_supplemental_data": "509000000",
                    "interest_paid_supplemental_data": "120000000",
                    "investing_cash_flow": "-6077000000",
                    "issuance_of_debt": "0",
                    "long_term_debt_issuance": "0",
                    "long_term_debt_payments": "-267000000",
                    "net_business_purchase_and_sale": "-38000000",
                    "net_common_stock_issuance": "-3569000000",
                    "net_income_from_continuing_operations": "11583000000",
                    "net_investment_purchase_and_sale": "467000000",
                    "net_issuance_payments_of_debt": "-267000000",
                    "net_long_term_debt_issuance": "-267000000",
                    "net_other_financing_charges": "-2039000000",
                    "net_other_investing_changes": "-10000000",
                    "net_ppepurchase_and_sale": "-6496000000",
                    "operating_cash_flow": "20402000000",
                    "other_non_cash_items": "74000000",
                    "purchase_of_business": "-38000000",
                    "purchase_of_investment": "-1007000000",
                    "purchase_of_ppe": "-6543000000",
                    "repayment_of_debt": "-267000000",
                    "repurchase_of_capital_stock": "-3569000000",
                    "sale_of_investment": "1474000000",
                    "sale_of_ppe": "47000000",
                    "stock_based_compensation": "3492000000"
                },
               ...
            ]
        }
    }
}

```
------

> **TIP:** What can you use as filters for the Cash Flow API output?
> -	Cash flow statement type. Was it an annual report? Quarterly? &type= year, quarter, ttm (trailing twelve months). This way you can fetch certain report types only. When not added, the default is quarterly.
> -	Date range. Set the &date_from and &date_to parameters to get reports within this specific window. When not added, you will get the cash flow data on recent reports only.

------

### Balance Sheet API

Example Balance Sheet API output based on META.

```
https://api.finnworlds.com/api/v1/balancesheets?key=APIKEY&ticker=META

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "ticker": "META",
            "period": "quarterly"
        },
        "output": {
            "balance_sheet": [
                {
                    "date": "2023-09-30",
                    "accounts_payable": "4372000000",
                    "accounts_receivable": "12944000000",
                    "accumulated_depreciation": "-30848000000",
                    "additional_paid_in_capital": "71224000000",
                    "available_for_sale_securities": "6142000000",
                    "buildings_and_improvements": "35422000000",
                    "capital_lease_obligations": "17834000000",
                    "capital_stock": "0",
                    "cash_and_cash_equivalents": "36890000000",
                    "cash_cash_equivalents_and_short_term_investments": "61123000000",
                    "cash_equivalents": "31557000000",
                    "cash_financial": "5333000000",
                    "common_stock": "0",
                    "common_stock_equity": "142873000000",
                    "construction_in_progress": "22945000000",
                    "current_accrued_expenses": "9422000000",
                    "current_assets": "78378000000",
                    "current_capital_lease_obligation": "1460000000",
                    "current_debt_and_capital_lease_obligation": "1460000000",
                    "current_liabilities": "30531000000",
                    "dueto_related_parties_current": "770000000",
                    "gains_losses_not_affecting_retained_earnings": "-3556000000",
                    "goodwill": "20668000000",
                    "goodwill_and_other_intangible_assets": "21481000000",
                    "gross_ppe": "135653000000",
                    "invested_capital": "161256000000",
                    "investmentin_financial_assets": "6142000000",
                    "investments_and_advances": "6142000000",
                    "land_and_improvements": "1900000000",
                    "leases": "6841000000",
                    "long_term_capital_lease_obligation": "16374000000",
                    "long_term_debt": "18383000000",
                    "long_term_debt_and_capital_lease_obligation": "34757000000",
                    "net_ppe": "104805000000",
                    "net_tangible_assets": "121392000000",
                    "ordinary_shares_number": "2571000000",
                    "other_current_assets": "4311000000",
                    "other_current_liabilities": "4931000000",
                    "other_equity_adjustments": "-3556000000",
                    "other_intangible_assets": "813000000",
                    "other_non_current_assets": "5468000000",
                    "other_non_current_liabilities": "1281000000",
                    "other_properties": "68545000000",
                    "other_short_term_investments": "24233000000",
                    "payables": "9750000000",
                    "payables_and_accrued_expenses": "19172000000",
                    "pensionand_other_post_retirement_benefit_plans_current": "4968000000",
                    "properties": "0",
                    "receivables": "12944000000",
                    "retained_earnings": "75205000000",
                    "share_issued": "2571000000",
                    "stockholders_equity": "142873000000",
                    "tangible_book_value": "121392000000",
                    "total_assets": "216274000000",
                    "total_capitalization": "161256000000",
                    "total_debt": "36217000000",
                    "total_equity_gross_minority_interest": "142873000000",
                    "total_liabilities_net_minority_interest": "73401000000",
                    "total_non_current_assets": "137896000000",
                    "total_non_current_liabilities_net_minority_interest": "42870000000",
                    "total_tax_payable": "4608000000",
                    "tradeand_other_payables_non_current": "6832000000",
                    "working_capital": "47847000000"
                },
             ...
            ]
        }
    }
}

```
-------

> **TIP:** Same as the Cash Flows API. The ticker is a required field. You can filter the balance sheet API data more by adding type, date_from and date_to parameters.

-------

### Income Statements API

Finally, one example of Income Statements API output for META.

```
https://api.finnworlds.com/api/v1/incomestatements?key=APIKEY&ticker=META

{
    "status": {
        "code": 200,
        "message": "OK",
        "details": ""
    },
    "result": {
        "basics": {
            "ticker": "META",
            "period": "quarterly"
        },
        "output": {
            "income_statement": [
                {
                    "date": "2023-09-30",
                    "basic_average_shares": "2576000000",
                    "basic_eps": "4.5",
                    "cost_of_revenue": "6210000000",
                    "diluted_average_shares": "2641000000",
                    "diluted_eps": "4.39",
                    "diluted_niavailto_com_stockholders": "11583000000",
                    "ebit": "14159000000",
                    "ebitda": "17018000000",
                    "gain_on_sale_of_security": "-98000000",
                    "general_and_administrative_expense": "2070000000",
                    "gross_profit": "27936000000",
                    "interest_expense": "139000000",
                    "interest_expense_non_operating": "139000000",
                    "interest_income": "534000000",
                    "interest_income_non_operating": "534000000",
                    "net_income": "11583000000",
                    "net_income_common_stockholders": "11583000000",
                    "net_income_continuous_operations": "11583000000",
                    "net_income_from_continuing_and_discontinued_operation": "11583000000",
                    "net_income_from_continuing_operation_net_minority_interest": "11583000000",
                    "net_income_including_noncontrolling_interests": "11583000000",
                    "net_interest_income": "370000000",
                    "net_non_operating_interest_income_expense": "370000000",
                    "normalized_ebitda": "17116000000",
                    "normalized_income": "11664340000",
                    "operating_expense": "14188000000",
                    "operating_income": "13748000000",
                    "operating_revenue": "33853000000",
                    "other_gand_a": "2070000000",
                    "other_income_expense": "-98000000",
                    "pretax_income": "14020000000",
                    "reconciled_cost_of_revenue": "6210000000",
                    "reconciled_depreciation": "2859000000",
                    "research_and_development": "9241000000",
                    "selling_and_marketing_expense": "2877000000",
                    "selling_general_and_administration": "4947000000",
                    "tax_effect_of_unusual_items": "-16660000",
                    "tax_provision": "2437000000",
                    "tax_rate_for_calcs": "0.17",
                    "total_expenses": "20398000000",
                    "total_operating_income_as_reported": "13748000000",
                    "total_other_finance_cost": "25000000",
                    "total_revenue": "34146000000",
                    "total_unusual_items": "-98000000",
                    "total_unusual_items_excluding_goodwill": "-98000000"
                },
               ...
            ]
        }
    }
}

```
----------

### Financial Statements Data - Conclusion

I hope this article inspired you about what you can build with Finnworlds financial statements data which you can [access here](https://finnworlds.com/pricing/). **To sum up**, you can access the complete content of 3 key financial statements in JSON format by using this financial statements API. It is possible to set a date and a ticker to get the exact historical or recent financial statement you want.