FIfinancialdatasets
Earnings

Get earnings snapshot

Changed on

Get the most recent earnings snapshot for a ticker. Optional change fields are returned only when available.

get/earnings

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

tickerstring required

The ticker symbol (e.g. AAPL).

limitinteger

Number of most-recent report periods worth of filings to return, sorted by (report_period DESC, filing_date ASC). The number of entries returned may exceed limit when a recent period has both an 8-K and a 10-Q / 10-K. Values above 40 are clamped to 40. Non-positive or non-integer values return 400. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Earnings response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Changes

  • 5872e134b56cRevision changes
    • info

      added the new optional query request parameter cursor

    • info

      added the optional property to the response with the status