ApiFinance AI logo
Dashboard Sign in

Earnings

Retrieve the latest known earnings release and upcoming earnings schedule signals for a symbol.

Use this endpoint when you need a lightweight earnings schedule layer without rebuilding company-specific calendar logic.

Endpoint

GET /stocks/{symbol}/earnings
Test request
/stocks/AAPL/earnings

You can inspect the health endpoint without a key, but most endpoints require one. Create a free account to run the full workflow.

Send a request to view the response.

Authentication

Required.

Authorization: Bearer <your_api_key>

Path Parameters

  • symbol: ticker or symbol to resolve

Response Notes

  • V1 is a schedule and latest-release snapshot, not a full consensus-surprise history endpoint.
  • Current source coverage includes:
    • latest_earnings_release_date
    • past_earnings_date
    • next_earnings_date
    • eps_latest_q
  • Estimate and surprise fields are reserved in the response shape and may be null until richer source coverage is added.

Example Request

curl -H "Authorization: Bearer $your_api_key" \
  "https://api.apifinance.ai/stocks/AAPL/earnings"

Related Endpoints

Next step

Run this endpoint with your own API key

Use the playground to inspect the response first, then create a key and move into implementation once the payload fits your product.

Get Free API KeyOpen playground

Valuation History

Retrieve a monthly valuation history series built from imported price history and the latest available valuation anchors.

Estimates

Retrieve forward earnings and revenue growth estimate signals for the next quarter, next fiscal year, and long-term outlook.