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).

(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
394ms429ms443ms857ms1336ms

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

/v1/earnings GET

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

Returns detailed earnings report data for a specific company, period, and year. This includes comprehensive financial statements and key performance metrics. You can identify the company using either a ticker symbol or CIK (Central Index Key).

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

If you do not specify a year or period, the API will return the most recent earnings data.

  • ticker  optional

    Company ticker symbol (e.g., ADBE). Either ticker or cik must be provided.

  • cik  optional

    Company Central Index Key (e.g., 796343). Either ticker or cik must be provided.

  • period  optional

    Fiscal period. Must be one of: q1, q2, q3, q4, or fy (full year). If set, year must also be set.

  • year  optional

    Fiscal year. E.g. 2025. Must be a valid year after 2000. For historical earnings data before 2025, you must have a premium subscription. If set, period must also be set.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

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

Try this API endpoint with all available parameters in our API playground

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

Headers

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

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/earnings?ticker=ADBE&year=2025&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.