List earnings filings

GET /v1/earnings

Returns earnings-focused rows filtered by earnings id, symbol, scrip code, quarter, date range, pagination, and optional detailed mode. List responses do not include attachment URLs.

When to use it

Use this endpoint for result calendars, earnings feeds, and automated result-tracking workflows. For near-live delivery with attachment URLs included, see WebSocket earnings streams. When a user opens a filing, resolve the document with GET /v1/earnings/attachments for that id only — do not prefetch attachments for every row because each ready URL costs 1 credit.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: 1–2 credits / item. detailed=false: 1 credit per returned item. detailed=true: 2 credits per returned item.
See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

Field	Location	Required	Notes
`ids`	query	No	Optional comma-separated earnings filing ids or repeated query parameters. Maximum 20 ids.
`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.
`quarter`	query	No	Optional fiscal quarter key in `qN_YY` format, such as `q4_26`.
`from`	query	No	Optional ISO date or datetime lower bound. The lower bound is inclusive.
`to`	query	No	Optional ISO date or datetime upper bound. The upper bound is inclusive.
`page`	query	No	Page number. Defaults to `1`.
`limit`	query	No	Page size. The default is route-specific and is usually `20` or `50`.
`detailed`	query	No	Set `true` for richer fields including earnings tables. Defaults to `false`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns paginated earnings list or detailed earnings records depending on detailed. date is the ingestion time of the results filing. Each row includes quarter when available. Detailed rows may include earnings_table. Attachment URLs are not included; use GET /v1/earnings/attachments or the earnings WebSocket stream when needed.

Show Schema

Examples

Successful Responseapplication/json

{
  "data": [
    {
      "id": "6a0028a6d2c4b9b76419e970",
      "symbol": "PAISALO",
      "scrip_code": "532810",
      "company_name": "Paisalo Digital Limited",
      "image": "https://example.com/logos/paisalo.png",
      "quarter": "q4_26",
      "date": "2026-05-10T12:11:42.600000+00:00",
      "summary": "Standalone and consolidated revenue and profit improved YoY, the board recommended a final dividend, and it approved additional debt fundraising capacity."
    }
  ],
  "has_next": true
}

Request pattern

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

JavaScript / TypeScript SDK

const earnings = await client.getEarnings({ ids: ["67c2f8a1b2c3d4e5f6a7b8c9"], symbols: ["RELIANCE"], quarter: "q4_26", limit: 3 })

Python SDK

earnings = client.get_earnings(ids=["67c2f8a1b2c3d4e5f6a7b8c9"], symbols=["RELIANCE"], quarter="q4_26", limit=3)

Interactive reference

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