---
title: "Earnings calendar"
method: GET
path: "/api/v2/quotes/{symbol}/calendar"
tags: ["Finance"]
---

# Earnings calendar

`GET /api/v2/quotes/{symbol}/calendar`

Upcoming earnings dates and dividend events.

## Path parameters

- `symbol` string, required — Security ticker symbol.

## Response `200`

Upcoming earnings and dividend calendar.

- EnvelopeQuotesSymbolCalendarData
  - `data` QuotesSymbolCalendarData, required
    - `calendarEvents` CalendarEvents, required
      - `earnings` Earnings, required
        - `earningsDate` string[], required — Array of next earnings date candidates.
        - `earningsCallDate` string[], required — Array of earnings call date candidates.
        - `isEarningsDateEstimate` boolean, required — Flag: earnings date is an estimate.
        - `earningsAverage` number, required — Average EPS estimate for the upcoming report.
        - `earningsLow` number, required — Low EPS estimate for the upcoming report.
        - `earningsHigh` number, required — High EPS estimate for the upcoming report.
        - `revenueAverage` integer, required — Average revenue estimate for the upcoming report.
        - `revenueLow` integer, required — Low revenue estimate for the upcoming report.
        - `revenueHigh` integer, required — High revenue estimate for the upcoming report.
      - `exDividendDate` string, required — Ex-dividend date (epoch or ISO).
      - `dividendDate` string, required — Dividend payment date (epoch or ISO).
    - `earningsTrend` EarningsTrend, required
      - `trend` TrendItem[], required — Trend array.
        - `period` string, required — Time period identifier.
        - `endDate` string, required — End date (YYYY-MM-DD).
        - `growth` string, required — Growth rate or percent change.
        - `earningsEstimate` EarningsEstimate, required
          - `avg` string, required — Average value.
          - `low` string, required — Period low value.
          - `high` string, required — Period high value.
          - `yearAgoEps` string, required — Earnings per share from the year-ago comparable period.
          - `numberOfAnalysts` string, required — Number of analyst estimates.
          - `growth` string, required — Growth rate or percent change.
          - `earningsCurrency` string, required — Reporting currency for earnings estimates.
        - `revenueEstimate` RevenueEstimate, required
          - `avg` string, required — Average value.
          - `low` string, required — Period low value.
          - `high` string, required — Period high value.
          - `numberOfAnalysts` string, required — Number of analyst estimates.
          - `yearAgoRevenue` string, required — Revenue from the year-ago comparable period.
          - `growth` string, required — Growth rate or percent change.
          - `revenueCurrency` string, required — Reporting currency for revenue estimates.
        - `epsTrend` EpsTrend, required
          - `current` string, required — Flag or value: currently applicable.
          - `7daysAgo` string, required — Value as of 7 days ago.
          - `30daysAgo` string, required — Value as of 30 days ago.
          - `60daysAgo` string, required — Value as of 60 days ago.
          - `90daysAgo` string, required — Value as of 90 days ago.
          - `epsTrendCurrency` string, required — Reporting currency for EPS trend.
        - `epsRevisions` EpsRevisions, required
          - `upLast7days` string, required — Upward revisions in the last 7 days.
          - `upLast30days` string, required — Upward revisions in the last 30 days.
          - `downLast30days` string, required — Downward revisions in the last 30 days.
          - `downLast7Days` union, required — Downward revisions in the last 7 days.
            - integer
            - string
          - `downLast90days` object, required — Downward revisions in the last 90 days.
          - `epsRevisionsCurrency` string, required — Reporting currency for EPS revisions.
      - `defaultMethodology` string, required — Default estimation methodology.
  - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope.
    - `endpoint` string, required — Requested endpoint path.
    - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request.
    - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced.
    - `provider` string, required — API name and version.
    - `source` string, nullable — Identifier of the primary upstream source used for this response.
    - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response.
    - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data.
    - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried.
    - `cached` boolean, nullable — True when this response was served from the internal cache.
    - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data.

## Other responses

- `401` — Missing or invalid `x-api-key` header. JSON body with a stable `code` distinguishing `missing_api_key` (no header sent) from `invalid_api_key` (header sent, key not accepted); any other 401 source carries the generic `unauthorized` with its detail as `reason`. Plus `hint`. `plan` is always null on 401 - an unauthenticated request has no plan; quota exhaustion is 429, not 401.
- `422` — Validation Error
- `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window.
- `503` — Upstream source is temporarily unavailable. Retry after a short delay.

---

[API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/d3e3d9c28132/schema)