List upcoming earnings

GET /v1/earnings/upcoming

Returns upcoming event_calendar rows whose purpose mentions Financial Results, sorted by nearest date first. Rows are excluded when latest_earnings already contains the same symbol and quarter.

When to use it

Use this endpoint for earnings calendars, board-meeting monitoring, and pre-results research workflows before filings land in GET /v1/earnings.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: Free. Free.
See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

Field	Location	Required	Notes
`symbols`	query	No	Optional comma-separated values such as `RELIANCE,TCS` or repeated query parameters. Maximum 20 symbols.
`scrip_codes`	query	No	Optional comma-separated values such as `500325,532540` or repeated query parameters. Maximum 20 scrip codes.
`page`	query	No	Page number. Defaults to `1`.
`limit`	query	No	Page size. Defaults to `20`, maximum `50`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns paginated upcoming earnings rows with symbol, quarter (for example q4_26), date, company, purpose, title, bm_desc, body, and event_id. date is the scheduled results date.

Show Schema

Successful Responseapplication/json

{
  "data": [
    {
      "id": "6a015f446ec560b11681e3d1",
      "event_id": "9dc1cc6f962f061054319eeb5d96593f5bea568a155fbce074f0209b192b66ac",
      "bm_desc": "To consider and approve the financial results for the period ended Jun 30, 2026",
      "body": "Board to approve Q1 FY27 quarterly results.",
      "company": "Reliance Industries Limited",
      "date": "2026-07-28T00:00:00+00:00",
      "purpose": "Financial Results",
      "symbol": "RELIANCE",
      "title": "Financial Results for Q4 FY26",
      "quarter": "q1_27"
    }
  ],
  "has_next": true
}

Request pattern

curl -G "https://developers.manasija.in/v1/earnings/upcoming" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "limit=20"

JavaScript / TypeScript SDK

const upcoming = await client.getUpcomingEarnings({ limit: 20 })

Python SDK

upcoming = client.get_upcoming_earnings(limit=20)

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.