Browse documentation
API referenceGET/v1/concalls1–2 credits / item

List conference calls

GET /v1/concalls

Returns conference-call metadata filtered by symbol, scrip code, date range, pagination, and optional detailed mode.

When to use it

Use this endpoint for concall libraries, transcript pipelines, and management-commentary workflows. For near-live delivery, see WebSocket conference-call streams.

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.

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.
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.
detailedqueryNoSet true for expanded call analysis when available.
api_keyqueryNoOptional alternative to the X-API-Key header. Prefer the header for server-side applications.

Response

Returns paginated conference-call list or detailed records depending on detailed. date is the ingestion time of the concall filing. Detailed rows may include expanded_analysis.

Examples
Successful Responseapplication/json
{
  "data": [
    {
      "id": "6a015a84d2c4b9b76419e9a2",
      "symbol": "SHILCTECH",
      "short_analysis": {
        "guidance": "FY27 revenue target of roughly INR 800 crore with 29 to 31 percent EBITDA margins.",
        "redflags": "Margins remain exposed to commodity inflation and shipment timing."
      },
      "transcript_url": "https://767579b349213bb8b367495226a5488f.r2.cloudflarestorage.com/example-concall.pdf?X-Amz-Signature=example",
      "sentiment_analysis": {
        "sentiment": {
          "key_indicators": {
            "positive": [
              "Strong order book and capacity expansion on track"
            ],
            "negative": [
              "Raw material cost pressure and export shipment delays"
            ]
          }
        }
      },
      "quarter": "q4_26",
      "date": "2026-05-11T09:56:44.383000"
    }
  ],
  "has_next": true
}

Request pattern

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

JavaScript / TypeScript SDK

ts
const calls = await client.getConcalls({ symbols: ["RELIANCE"], limit: 2 })

Python SDK

python
calls = client.get_concalls(symbols=["RELIANCE"], limit=2)

Interactive reference

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