List upcoming conference calls

GET /v1/concalls/upcoming

Returns rows from latest_concalls where meeting_date is in the future, sorted by nearest meeting first. meeting_date is the scheduled call time in UTC.

When to use it

Use this endpoint for earnings-call calendars, intimation monitoring, and pre-call research workflows.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: Free–5 credits / page. detailed=false: free. detailed=true: 5 credits per page with results and includes intimation_attachment.
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`.
`detailed`	query	No	Set `true` to include the meeting-intimation attachment URL per row.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns paginated upcoming concall rows with symbol, quarter, and meeting_date. meeting_date is the scheduled call time. Detailed mode adds intimation_attachment.

Show Schema

Examples

Successful Responseapplication/json

{
  "data": [
    {
      "id": "6a015b37d2c4b9b76419e9a4",
      "symbol": "YASHO",
      "quarter": "q4_26",
      "meeting_date": "2026-05-19T10:30:00+00:00"
    }
  ],
  "has_next": true
}

Request pattern

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

JavaScript / TypeScript SDK

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

Python SDK

upcoming = client.get_upcoming_concalls(limit=20)

Interactive reference

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