FAQs

Answers to questions we hear often. Missing something? Get in touch.

What data does the API cover?

RNS regulatory announcements on every plan. On Advanced and Ultimate you also get:

  • NAV for funds and investment trusts: the latest figure, the whole universe in one call, or a history
  • Buybacks: every repurchase an issuer has announced, plus NAV accretion per share and average discount to NAV
  • Dividends: every declared dividend, and where the cycle stands now
  • Corporate events: results, AGMs and dividend dates
  • Performance: the return figures an issuer states in its own reports

Buyback prices and dividend amounts are reported in the unit the announcement used and are never converted. Read price.unit / amount.unit alongside every figure: 604.00 with unit: minor and 6.04 with unit: major are the same amount.

Why don't I see the same announcements as on the LSEG website?

The API returns every announcement published via the Regulatory News Service (RNS), in chronological order. LSEG's own public website applies additional filtering and presentation on top of the underlying feed, so what you see there is a subset of what the API returns.

If you'd like to compare the API against a UI, RNS is our UI for the same feed. By default it applies our editorial filter, surfacing only announcements our analysts consider price-sensitive or otherwise notable; toggle to unfiltered to see exactly the same feed as the API.

How quickly do announcements appear on the API?

It depends on your plan:

  • Free and Lite: 15-minute delay
  • Advanced and Ultimate: low-latency delivery, typically within a few seconds of the announcement clearing RNS

See the Pricing page for the per-plan delay.

How often should I poll the disclosures endpoint?

Use the sinceCursor polling pattern: capture meta.paging.latestCursor from each response and pass it back as sinceCursor on your next request. Empty polls return immediately with zero items, so a 1-minute polling interval costs roughly 10,000 requests/week, comfortably inside the Advanced quota.

Don't use pageCursor or pageNumber for polling. Those modes walk a static result set and won't pick up new items inserted while you're paging.

See Pagination for the full polling pattern and Rate Limits for sizing your interval to your plan's quota.

How far back does the historical data go?

History depth is set per plan:

PlanHistory
Free7 days
Lite30 days
Advanced1 year
Ultimate3 years

When you filter by isin or symbol, the default dateFrom window is dropped, so you'll see the full history your plan entitles you to for that instrument. See Filtering RNS items for details and Pricing for the full plan breakdown.

Are webhooks supported?

Yes, on the Ultimate plan. Webhooks deliver new RNS announcements to your endpoint as they're released, removing the need to poll. Configure delivery endpoints from the Console.

Plans below Ultimate should use sinceCursor polling instead. See Pagination.