---
title: "live news headline"
method: POST
path: "/data/newsheadline"
tags: ["Data API's"]
---

# live news headline

`POST /data/newsheadline`

Fetch the latest news headlines as of now, filterable by category and stock, capped at limit (max 50) items.

## Headers

- `access-token` string, required

## Request body

- NewsHeadlineRequest
  - `dhanClientId` string, required — User specific identification generated by Dhan
  - `categories` string[], required — News category filter. ALL returns all categories, unfiltered. Mandatory - cannot be null, omitted, or an empty array.
  - `limit` integer, required — Max number of news items to return, counted from the current date/time backwards. Allowed range is 1 to 50. For eg. 50
  - `universe` 'PORTFOLIO' | 'WATCHLIST' | 'PORTFOLIO' | 'WATCHLIST' — Scopes the news to the caller's portfolio or watchlist. Optional - omit for no scoping (must be a string, not null , not empty).
  - `stockList` string[] — Security IDs to filter news by specific stocks. Empty array or omitted means no stock filter. Optional, but if included must be an array (null is not allowed) and cannot contain null entries.

## Response `200`

Successful operation

- NewsHeadlineResponse
  - `data` NewsData — Container object. latestNews/nextNews hold the returned news items, filtered by category/stock and paginated per the request.
    - `latestNews` NewsHeadlineDetail[] — List of latest news items matching the request filters. Empty when the vendor has no items for this bucket (e.g. narrow date/time filters where matches only fall under nextNews).
      - `newsObject` NewsObject — Article headline, sentiment, and full text.
        - `overallSentiment` 'positive' | 'negative' | 'neutral' — Sentiment of the article.
        - `title` string — Article headline.
        - `text` string — Full article body/summary.
      - `category` string — Top-level news category.
      - `subCategory` string — News sub-category.
      - `publishDate` string — Article publish date, in YYYY-MM-DD format.
      - `stockName` string — Full company name.
      - `isinCode` string — ISIN of the security.
      - `smSymbol` string — Short market symbol.
      - `nseScripCode` integer — NSE scrip code.
      - `bseScripCode` integer — BSE scrip code.
      - `displaySymbol` string — Human-readable display name.
      - `tickSize` number, double — Minimum price movement.
      - `lotSize` integer — Units per market lot.

---

[API](https://skmtc.dev/dhan/apis/dhanhq-api.md) · [All operations](https://skmtc.dev/dhan/apis/dhanhq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dhan/dhanhq-api/revisions/2d368b9ed32d/schema)