List announcements

GET /v1/announcements

Returns announcement rows filtered by symbol, scrip code, category, date range, important-only mode, and optional detailed mode. List responses do not include attachment URLs.

When to use it

Use this endpoint for corporate-action feeds, filing triage, and event-monitoring products. For near-live announcement delivery, see WebSocket announcement 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.

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.
`categories`	query	No	Optional category filter. Accepts comma-separated values or repeated query parameters. Maximum 20 unique categories.
`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 rows such as long summaries and related categories. Defaults to `false`.
`important`	query	No	Set `true` to return only announcements marked important by the pipeline. 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 announcement records without attachment URLs. date is the ingestion time: when Drishti ingested the announcement. Detailed rows include richer summary and structured extracted_information when available. Announcement REST and WebSocket payloads do not include title, headline, descriptor, attachment URLs, or R2 keys.

Show Schema

Examples

Successful Responseapplication/json

{
  "data": [
    {
      "id": "6a015e446ec560b11681e3c9",
      "symbol": "MSAFE",
      "company_name": "Msafe Equipments Limited",
      "image": "https://example.com/logos/msafe.png",
      "date": "2026-05-11T10:12:44.875000",
      "summary": "Msafe Equipments Limited will host an earnings conference call on May 14, 2026, at 11:00 am IST to discuss results for the half year and full year ended March 31, 2026.",
      "category": "Meeting Intimation",
      "related_categories": []
    }
  ],
  "has_next": true
}

Request pattern

curl -G "https://developers.manasija.in/v1/announcements" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "symbols=RELIANCE" \
  --data-urlencode "important=true" \
  --data-urlencode "detailed=true" \
  --data-urlencode "limit=20"

JavaScript / TypeScript SDK

const announcements = await client.getAnnouncements({
  symbols: ["RELIANCE"],
  important: true,
  detailed: true,
  limit: 20,
})

Python SDK

announcements = client.get_announcements(
    symbols=["RELIANCE"],
    categories=["Corporate Action"],
    important=True,
    detailed=True,
    limit=20,
)

Interactive reference

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