Browse documentation
API referenceGET/v1/earnings/indexFree

List earnings index

GET /v1/earnings/index

Returns compact earnings rows filtered by symbol, scrip code, quarter, date range, and pagination without full filing payloads.

When to use it

Use this free index to scan recent results by symbol and quarter, then open GET /v1/earnings or GET /v1/earnings/detail for full records.

Authentication and billing

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

Request

This endpoint does not require a request body.

FieldLocationRequiredNotes
symbolsqueryNoOptional comma-separated values such as RELIANCE,TCS or repeated query parameters. Maximum 20 symbols.
scrip_codesqueryNoOptional comma-separated values such as 500325,532540 or repeated query parameters. Maximum 20 scrip codes.
quarterqueryNoOptional fiscal quarter key in qN_YY format, such as q4_26.
fromqueryNoOptional ISO date or datetime lower bound. The lower bound is inclusive.
toqueryNoOptional ISO date or datetime upper bound. The upper bound is inclusive.
pagequeryNoPage number. Defaults to 1.
limitqueryNoPage size. The default is route-specific and is usually 20 or 50.
api_keyqueryNoOptional alternative to the X-API-Key header. Prefer the header for server-side applications.

Response

Returns paginated lightweight rows with id, symbol, optional quarter, and optional date. date is the ingestion time of the results filing.

Successful Responseapplication/json
{
  "data": [
    {
      "id": "6a0028a6d2c4b9b76419e970",
      "symbol": "PAISALO",
      "quarter": "q4_26",
      "date": "2026-05-10T12:11:42.600000+00:00"
    }
  ],
  "has_next": true
}

Request pattern

bash
curl -G "https://developers.manasija.in/v1/earnings/index" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "symbols=RELIANCE" \
  --data-urlencode "quarter=q4_26" \
  --data-urlencode "limit=20"

JavaScript / TypeScript SDK

ts
const index = await client.getEarningsIndex({ symbols: ["RELIANCE"], quarter: "q4_26", limit: 20 })

Python SDK

python
index = client.get_earnings_index(symbols=["RELIANCE"], quarter="q4_26", limit=20)

Interactive reference

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