Filtering RNS Items

The /v2/disclosures/sources/rns/items endpoint returns every announcement on the Regulatory News Service (RNS). RNS is LSEG's distribution channel for regulatory and corporate disclosures, used by UK-listed, AIM, unlisted, and foreign issuers. Add filter parameters to narrow the response to the announcements you care about.

Filter dimensions

Filters combine with AND across dimensions and OR within a dimension. isin=GB00X&isin=GB00Y&tickerCategory=RE returns Results announcements for either GB00X or GB00Y.

Passing multiple values

Every multi-value filter accepts two equivalent forms:

• Comma-separated on the plural name: ?isins=A,B,C
• Repeated on the singular name: ?isin=A&isin=B&isin=C

Pick one form per dimension. If both isins and isin are supplied, the singular form is ignored and the API returns a warning in the response.

# Comma form
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbols=VOD,LLOY,BARC"

# Repeated form
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbol=VOD&symbol=LLOY&symbol=BARC"

Filtering by instrument or listing

isin matches the 12-character ISO 6166 code, which identifies the underlying instrument across all venues. symbol matches the LSE ticker mnemonic (VOD, LLOY, BARC, …), which identifies a specific listing on the London Stock Exchange. For an LSE-listed security, either filter will resolve to the same announcements.

# By symbol
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbol=VOD"

# By ISIN
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?isin=GB00BL3DYY54"

Filtering by category

Each RNS announcement carries two parallel category tags: the official FCA code from the regulator's scheme, and a Ticker-curated code that groups related FCA codes into a smaller, stabler set. Filter by whichever fits your use case.

Ticker categories

Eleven coarse categories that group related FCA codes. Use these for a high-level filter (e.g. "everything board-related") without enumerating the underlying codes.

# All Results announcements
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?tickerCategory=RE"

FCA categories

The official codes from the FCA's DTR 8 Annex 2 disclosure scheme, plus a small number of RNS-only codes (AIM, NRA, EXC, …) used for non-regulatory or Reach-distributed announcements. Use these when you need a specific announcement category.

# All Final Results announcements
curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?fcaCategory=FR"

See Categories for the full list of Ticker, FCA, and RNS codes and how they map to one another.

Headline search

q does a substring match against the announcement headline. It is not a full-text or fuzzy search; combine it with category filters for the best precision.

curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?q=acquisition&tickerCategory=AA"

Interaction with dateFrom

By default, dateFrom is implicitly set to 30 days before dateTo (or 30 days ago if both are omitted). This default is dropped when you filter by isin or symbol, on the assumption that you want the full available history for that instrument.

See Pagination for the full dateFrom / dateTo semantics, including partial-date expansion.

Recipes

Watch a single instrument

curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbol=VOD"

All Results announcements for the year so far

curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?tickerCategory=RE&dateFrom=2026"

Portfolio watch (multi-symbol)

curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbols=VOD,LLOY,BARC"

For continuous polling, capture meta.paging.latestCursor and pass it as sinceCursor on the next request. See Pagination.

Director dealings across a watchlist

curl -H "x-api-key: KEY" \
  "https://api.tickerapp.net/v2/disclosures/sources/rns/items?symbols=VOD,LLOY,BARC&tickerCategory=DD"

Plan requirements

Some filters are entitlement-gated:

See Pricing for full plan capabilities.