NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Earnings API

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

Tracking upcoming report dates and analyst estimates, or reading the full earnings call? See the Earnings Calendar API and Earnings Call Transcript API.

(4.3)

From 5,843 users

3,600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
403ms443ms454ms816ms1301ms

Didn't find what you were looking for? Suggest an improvement

/v2/earnings GET

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

Returns a JSON array of detailed earnings reports, each with comprehensive financial statements and key performance metrics. Query a single company by ticker or cik, or query every company that filed within a date range using date or date_start/date_end. Results are paginated 50 per page via offset.

Q1, Q2, and Q3 earnings data are sourced from the 10-Q filings. Q4 earnings data is sourced from the 10-K filings by subtracting the Q1, Q2, and Q3 earnings from the 10-K earnings for income statement fields.

Parameters

Query by company — pass a ticker or cik — or query every company by filing date using date, or date_start/date_end for a range, with no ticker required. With only a ticker (no year or period), all of that company's filings are returned, most recent first. Results are paginated 50 per page — use offset to page through them.

  • ticker  optional

    Company ticker symbol (e.g., ADBE). Identifies the company to query — use this or cik, or omit both and query by date.

  • cik  optional

    Company Central Index Key (e.g., 796343). Alternative to ticker for identifying a company.

  • period  optional

    Fiscal period. Must be one of: q1, q2, q3, q4, or fy (full year). Requires a ticker/cik and year.

  • year  optional

    Fiscal year. E.g. 2026. Historical coverage goes back to 2010. For data before 2026, you must have a premium subscription. Combine with a ticker to return every period that year, or add period/quarter for a single filing.

  • quarter  optional

    Fiscal quarter 1–4 (an alternative to period). Requires a ticker/cik and year.

  • date  optional

    Return every filing whose SEC filing date equals this date (YYYY-MM-DD). Works without a ticker — returns all companies that filed that day.

  • date_start  optional

    Start of a filing-date range (YYYY-MM-DD): all companies that filed on or after this date. Cannot be combined with date.

  • date_end  optional

    End of a filing-date range (YYYY-MM-DD). Combine with date_start and page through results with offset.

  • offset  optional

    Number of results to skip for pagination. Results are returned 50 per page. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • company_info

    Company identification including ticker symbol (ticker), CIK, company name, fiscal year (fiscal_year), and fiscal quarter (fiscal_quarter).

  • 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 
period
cik

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v2/earnings?ticker=ADBE&year=2026&period=q2

Headers

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

Sample Response

JSON
[
    {
      company_info:{
        ticker:"ADBE",
        cik:"796343",
        company_name:"ADOBE INC.",
        fiscal_year:2026,
        fiscal_quarter:2
      },
      income_statement:{
        weighted_average_shares_basic:402000000,
        weighted_average_shares_diluted:402000000,
        earnings_per_share_basic:4.26,
        earnings_per_share_diluted:4.25,
        total_revenue:6618000000,
        cost_of_revenue:715000000,
        gross_profit:5903000000,
        research_and_development:null,
        general_and_administrative:546000000,
        sales_and_marketing:1884000000,
        operating_income:2238000000,
        interest_expense:65000000,
        tax_provision:526000000,
        net_income:1712000000,
        net_income_available_to_common:null,
        depreciation_and_amortization:367000000,
        stock_based_compensation:1043000000
      },
      balance_sheet:{
        cash_and_equivalents:4919000000,
        accounts_receivable:1993000000,
        inventory:null,
        current_assets:9068000000,
        property_plant_equipment:1870000000,
        goodwill:14041000000,
        intangible_assets:1012000000,
        total_assets:29933000000,
        accounts_payable:499000000,
        current_liabilities:12078000000,
        long_term_debt:4802000000,
        total_debt:6645000000,
        total_liabilities:18415000000,
        stockholders_equity:11518000000,
        retained_earnings:48767000000,
        working_capital:-3010000000,
        temporary_equity:null
      },
      cash_flow:{
        operating_cash_flow:5123000000,
        capital_expenditures:95000000,
        free_cash_flow:5028000000,
        dividends_paid:null,
        share_repurchases:4589000000,
        net_cash_investing:-1240000000,
        net_cash_financing:-4399000000
      },
      filing_info:{
        filing_type:"10-Q",
        filing_date:"2026-06-15",
        period_end_date:"2026-05-29"
      }
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v2/earnings?ticker=ADBE&year=2026&period=q2" \ -H "X-Api-Key: YOUR_API_KEY"

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.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Earnings API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The Earnings API returns comprehensive earnings report data for any public company listed in the United States, sourced directly from official SEC filings (10-Q and 10-K). Q1, Q2, and Q3 figures come from the 10-Q filings, while Q4 data is derived from the 10-K by subtracting the first three quarters for income statement fields. For company filing index data, see the related SEC API.
  • Identify the company with either the ticker parameter (e.g. ADBE) or the cik parameter (e.g. 796343), then set year and period together, where period must be one of q1, q2, q3, q4, or fy. If you omit year and period, the API returns the most recent earnings data; see all available finance endpoints at our APIs page.
  • Each response includes company_info, plus three full statement objects: income_statement (revenue, gross profit, operating income, net income, and EPS), balance_sheet (total assets, liabilities, equity, cash, and debt), and cash_flow (operating, investing, and financing flows, capex, and share repurchases), along with filing_info SEC metadata. For upcoming report dates, pair it with the Earnings Calendar API or read management commentary via the Earnings Call Transcript API.
  • Yes, the year parameter accepts any valid year after 2000, but accessing historical earnings data from before the current year requires a premium subscription. To get started and obtain access, you can create an account.