Skip to main content
GET
Python (SDK)

Query parameters

Response

Success returns 200 OK with a JSON object containing earnings quality data (e.g. data array with period, score, letterScore, profitability, growth, cashGenerationCapitalAllocation, leverage), freq, and symbol. Errors: 400 when symbol or freq is missing or invalid, 401 unauthorized, 404 when no data found, 500 server error.

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

symbol
string
required

Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. AAPL, MSFT.

Example:

"AAPL"

freq
enum<string>
required

How often the score is computed. Allowed values:

  • annual — one score per fiscal year (broad trends).
  • quarterly — one score per quarter (closer to recent reporting). How often the underlying data is reported:
  • annual — once per fiscal year (10-K, full-year statements).
  • quarterly — once per fiscal quarter (10-Q, quarterly statements).
Available options:
annual,
quarterly
Example:

"quarterly"

Response

Earnings quality score data.

Earnings quality score history for a company, as provided by Finnhub.

data
object[]

Earnings quality scores, one entry per reporting period.

freq
enum<string>

How often the underlying data is reported:

  • annual — once per fiscal year (10-K, full-year statements).
  • quarterly — once per fiscal quarter (10-Q, quarterly statements).
Available options:
annual,
quarterly
Example:

"quarterly"

symbol
string

Company ticker symbol.