Earnings API

The Earnings API provides comprehensive earnings report data for any company, including financial statements, balance sheets, cash flow statements, and key financial metrics. All data is sourced from official SEC filings (10-Q, 10-K).

/v1/earnings GET

https://api.api-ninjas.com/v1/earnings

Returns detailed earnings report data for a specific company, quarter, and year. This includes comprehensive financial statements and key performance metrics.


Parameters

  • ticker  required

    Company ticker symbol (e.g., ADBE).

  • quarter  required

    Fiscal quarter from Q1 to Q4. Must be between 1 and 4 (inclusive).

  • year  required

    Fiscal year. E.g. 2024.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

  • ticker

    The company ticker symbol.

  • quarter

    The fiscal quarter (1-4).

  • year

    The fiscal year.

  • company_info

    Company filing information including CIK, company name, filing type, filing date, and period end date.

  • income_statement

    Key income statement figures including revenue, gross profit, operating income, net income, earnings per share, and expense breakdowns.

  • balance_sheet

    Balance sheet data including total assets, liabilities, equity, cash, debt, and other key balance sheet items.

  • cash_flow

    Cash flow statement data including operating, investing, and financing cash flows, plus capital expenditures and share repurchases.

  • filing_info

    SEC filing metadata including filing type, filing date, and period end date.

Sample Request Live Demo!

ticker
year
quarter
https://api.api-ninjas.com/v1/earnings?ticker=ADBE&year=2024&quarter=2

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 { "ticker": "ADBE", "quarter": 2, "year": 2024, "company_info": { "ticker": "ADBE", "cik": "796343", "fiscal_year": 2024, "period_end_date": "2024-05-31", "company_name": "ADOBE INC.", "filing_date": "2024-06-26", "filing_type": "10-Q", "fiscal_quarter": 2 }, "income_statement": { "earnings_per_share_basic": 3.5, "interest_expense": 41000000, "sales_and_marketing": 1445000000, "operating_income": 1885000000, "tax_provision": 357000000, "gross_profit": 4711000000, "earnings_per_share_diluted": 3.49, "weighted_average_shares_basic": 449000000, "general_and_administrative": 355000000, "cost_of_revenue": 598000000, "stock_based_compensation": null, "total_revenue": 5309000000, "net_income": 1573000000, "research_and_development": 984000000, "depreciation_and_amortization": 42000000, "weighted_average_shares_diluted": 451000000 }, "balance_sheet": { "goodwill": 12803000000, "retained_earnings": 35227000000, "total_assets": 30007000000, "current_liabilities": 9474000000, "total_debt": null, "total_liabilities": 15164000000, "long_term_debt": 4127000000, "accounts_receivable": 1612000000, "inventory": null, "current_assets": 11023000000, "property_plant_equipment": 1969000000, "intangible_assets": 933000000, "working_capital": null, "accounts_payable": 357000000, "stockholders_equity": 14843000000, "cash_and_equivalents": 7660000000 }, "cash_flow": { "share_repurchases": -4500000000, "operating_cash_flow": 3114000000, "net_cash_investing": 177000000, "net_cash_financing": -2770000000, "free_cash_flow": null, "capital_expenditures": -78000000, "dividends_paid": null }, "filing_info": { "filing_type": "10-Q", "filing_date": "2024-06-26", "period_end_date": "2024-05-31" } }

Code Examples

1 2 3 4 5 6 7 8 9 10 11 12 import requests ticker = 'ADBE' year = 2024 quarter = 2 api_url = 'https://api.api-ninjas.com/v1/earnings?ticker={}&year={}&quarter={}'.format(ticker, year, quarter) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.