Skip to main content
GET
/
v1
/
earnings-reports
/
{exchange}
/
{symbol}
/
{fiscalPeriod}
Get a specific earning report.
curl --request GET \
  --url 'https://api.capyfin.com/v1/earnings-reports/{exchange}/{symbol}/{fiscalPeriod}?apikey='
{
  "id": "507f1f77bcf86cd799439011",
  "fiscalPeriod": "Q12024",
  "date": "2024-05-02T00:00:00.000Z",
  "instrument": {
    "id": "507f1f77bcf86cd799439011",
    "slug": "nasdaq-aapl",
    "symbol": "AAPL",
    "name": "Apple",
    "fullName": "Apple Inc.",
    "exchange": "nasdaq",
    "image": "https://assets.capyfin.com/instruments/507f1f77bcf86cd799439011.png",
    "marketCap": 3587432814000,
    "country": "US",
    "segments": [
      "<string>"
    ],
    "geo": [
      "<string>"
    ],
    "kpis": [
      "<string>"
    ],
    "investorRelationsUrl": "https://investor.apple.com",
    "closingPrice": 237.33,
    "returnLastDay": 1.92,
    "returnThisWeek": 3.24,
    "return2Years": 54.771,
    "return5Years": 281.63,
    "returnAll": 1432.26,
    "dividendYield": 0.4171,
    "dividendExDate": "2024-11-08T00:00:00.000Z",
    "dividendPayDate": "2024-11-14T00:00:00.000Z",
    "dividendUsd": 0.25,
    "dividendFrequency": "QUARTERLY",
    "dividendYearly": {
      "2023": 0.94,
      "2024": 0.97
    },
    "closeYearly": {
      "2023": 192.53,
      "2024": 237.33
    }
  },
  "reportTime": "amc",
  "currency": "USD",
  "totalRevenue": 94836000000,
  "eps": 1.53,
  "epsAdj": 1.53,
  "verified": true,
  "employees": 1000,
  "epsEstimated": 123,
  "revenueEstimated": 123,
  "netIncome": 123,
  "operatingIncome": 123,
  "grossProfit": 123,
  "metrics": [
    {}
  ],
  "summary": "<string>",
  "subtitle": "<string>",
  "keyTakeaways": [
    "<string>"
  ],
  "forwardSummary": "<string>",
  "forwardPositive": [
    "<string>"
  ],
  "forwardNegative": [
    "<string>"
  ],
  "callPositive": [
    "<string>"
  ],
  "callNegative": [
    "<string>"
  ]
}

Authorizations

​
apikey
string
query
required

Pass your API key as a query parameter (e.g., /endpoint?apikey=YOUR_API_KEY)

Path Parameters

​
exchange
string
required

The exchange of the instrument (e.g., nasdaq, nyse).

​
symbol
string
required

The symbol of the instrument (e.g., aapl, tsla).

​
fiscalPeriod
string
required

The fiscal period of the report (e.g. Q12024).

Response

200 - application/json
​
id
string
required

The unique identifier for the earning report.

Example:

"507f1f77bcf86cd799439011"

​
fiscalPeriod
string
required

The fiscal period of the report (e.g., Q12024, FY2023).

Example:

"Q12024"

​
date
string<date-time>
required

The release date of the earnings report.

Example:

"2024-05-02T00:00:00.000Z"

​
instrument
object
required

The instrument associated with this report.

​
reportTime
enum<string>

The time of day the report is released.

Available options:
amc,
bmo,
dm
Example:

"amc"

​
currency
string

The currency of the report values.

Example:

"USD"

​
totalRevenue
number

Total revenue reported.

Example:

94836000000

​
eps
number

Earnings Per Share (EPS).

Example:

1.53

​
epsAdj
number

Adjusted Earnings Per Share (Non-GAAP).

Example:

1.53

​
verified
boolean

Whether the report has been verified.

Example:

true

​
employees
number

Number of employees.

Example:

1000

​
epsEstimated
number

Estimated EPS.

​
revenueEstimated
number

Estimated Revenue.

​
netIncome
number

Net Income.

​
operatingIncome
number

Operating Income.

​
grossProfit
number

Gross Profit.

​
metrics
object[]

List of specific metrics for the report.

​
summary
string

Summary of the report.

​
subtitle
string

Subtitle of the report.

​
keyTakeaways
string[]

Key takeaways from the report.

​
forwardSummary
string

Summary of forward guidance.

​
forwardPositive
string[]

Positive points from forward guidance.

​
forwardNegative
string[]

Negative points from forward guidance.

​
callPositive
string[]

Positive points from the earnings call.

​
callNegative
string[]

Negative points from the earnings call.