GET
/
earnings
/
{symbol}
Get earnings data
curl --request GET \
  --url https://api.financialcontext.com/earnings/{symbol} \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "id": "earn_123456",
    "symbol": "AAPL",
    "date": "2023-10-18",
    "period": "Q3",
    "year": 2023,
    "status": "reported",
    "type": "actual",
    "eps": {
      "actual": 1.29,
      "estimate": 1.27,
      "surprise": 0.02,
      "surprise_percent": 1.57
    },
    "revenue": {
      "actual": 89498000000,
      "estimate": 89280000000,
      "surprise": 218000000,
      "surprise_percent": 0.24,
      "yoy_growth": 0.028,
      "qoq_growth": 0.045
    },
    "earnings_time": "2023-10-18T16:30:00Z",
    "before_market": false,
    "after_market": true,
    "call_time": "2023-10-18T17:00:00Z",
    "guidance": [
      {
        "period": "Q3",
        "year": 2024,
        "eps_guidance": {
          "low": 1.2,
          "high": 1.35,
          "midpoint": 1.275
        },
        "revenue_guidance": {
          "low": 88000000000,
          "high": 92000000000,
          "midpoint": 90000000000
        },
        "issued_date": "2023-10-18T16:30:00Z"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>"
  },
  "message": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "meta": {
    "pagination": {
      "currentPage": 1,
      "pageSize": 20,
      "totalItems": 150,
      "totalPages": 8,
      "hasMore": true,
      "hasPrevious": false
    }
  }
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
symbol
string
required

Stock symbol (e.g., AAPL, NASDAQ:AAPL)

Required string length: 1 - 20
Example:

"AAPL"

Query Parameters

​
period
enum<string>

Filter by earnings period

Available options:
Q1,
Q2,
Q3,
Q4,
FY
Example:

"Q3"

​
year
integer

Filter by earnings year

Required range: 2000 <= x <= 2100
Example:

2023

​
status
enum<string>

Filter by earnings status

Available options:
scheduled,
reported,
estimated,
revised
Example:

"reported"

​
type
enum<string>

Filter by earnings type

Available options:
actual,
estimate,
guidance
Example:

"actual"

​
include_guidance
boolean
default:false

Include earnings guidance

Example:

false

​
sort_by
enum<string>
default:date

Sort by field

Available options:
date,
period,
year,
createdAt,
updatedAt
Example:

"date"

​
sort_order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

​
from
string | null

Start date, format YYYY-MM-DD

Example:

"2023-01-01"

​
to
string | null

End date, format YYYY-MM-DD

Example:

"2023-12-31"

​
page
integer
default:1

Page number, starting from 1

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

1

​
page_size
integer
default:10

Number of items per page, range 1-100

Required range: -9007199254740991 <= x <= 9007199254740991
Example:

10

Response

Earnings data retrieved successfully

Single earnings record response

​
success
boolean
required

Indicates successful API response

​
data
object | null
required

Earnings data Earnings data model corresponding to database schema

​
timestamp
string<date-time>
required

ISO 8601 timestamp of the response

​
message
string

Optional success message

​
meta
object

Optional metadata including pagination, statistics, and additional context