GET/disclosures/sources/rns/items

List RNS disclosure items

Returns a paginated list of disclosure items from the RNS source, filtered by time range, instruments, categories and/or full-text query.

Code samples

curl -X GET 'https://api.tickerapp.net/v2/disclosures/sources/rns/items' \
  -H 'x-api-key: $TICKER_API_KEY'

Try it

Try it live

Send a real request to this endpoint with your API key. Sign in to try it from your browser.

Parameters

Query parameters

dateFrom

string

Filter items released on or after this date/time. Default: If not provided, defaults to 30 days before dateTo (or 30 days ago if dateTo is also omitted). This default does not apply when filtering by symbols or isins. Accepts partial ISO8601 dates that expand to the start of the period: 2025 → Jan 1st 00:00, 2025-11 → Nov 1st 00:00, 2025-12-31 → Dec 31st 00:00, 2025-12-31T14:30 → 14:30:00.

Examples: 2025 (Full year), 2025-11 (Full month), 2025-12-31 (Full day), 2025-12-31T14:30:00Z (Specific time)

dateTo

string

Filter items released on or before this date/time. Accepts partial ISO8601 dates that expand to the end of the period: 2025 → Dec 31st 23:59:59, 2025-11 → Nov 30th 23:59:59, 2025-12-31 → Dec 31st 23:59:59, 2025-12-31T14:30 → 14:30:59.

Examples: 2025 (Full year), 2025-11 (Full month), 2025-12-31 (Full day), 2025-12-31T14:30:00Z (Specific time)

isins

string

Filter by one or more ISINs (comma-separated). Example: isins=GB00AAA1111,GB00BBB2222. Use either isins (comma-separated) or isin (repeated), not both.

Lite or higher

isin

array of string

Filter by one or more ISINs (repeated parameter). Example: isin=GB00AAA1111&isin=GB00BBB2222. If both isins and isin are provided, isin is ignored and a warning is returned.

Lite or higher

symbols

string

Filter by ticker symbols (comma-separated). Example: symbols=VOD,LLOY. Use either symbols (comma-separated) or symbol (repeated), not both.

Lite or higher

symbol

array of string

Filter by ticker symbols (repeated parameter). Example: symbol=VOD&symbol=LLOY. If both symbols and symbol are provided, symbol is ignored and a warning is returned.

Lite or higher

fcaCategories

string

Filter by FCA category codes (comma-separated). Example: fcaCategories=FR,HOL,BOA. Use either fcaCategories (comma-separated) or fcaCategory (repeated), not both.

Advanced or higher

fcaCategory

array of string

Filter by FCA category codes (repeated parameter). Example: fcaCategory=FR&fcaCategory=HOL. If both fcaCategories and fcaCategory are provided, fcaCategory is ignored and a warning is returned.

Advanced or higher

tickerCategories

string

Filter by Ticker category codes (comma-separated). Example: tickerCategories=RE,HO,BC. Use either tickerCategories (comma-separated) or tickerCategory (repeated), not both.

Advanced or higher

tickerCategory

array of string

Filter by Ticker category codes (repeated parameter). Example: tickerCategory=RE&tickerCategory=HO. If both tickerCategories and tickerCategory are provided, tickerCategory is ignored and a warning is returned.

Advanced or higher

q

string

Full-text search over headline

Advanced or higher

pageSize

integer

Number of items per page (default 50, max 200)

Default: 50

pageCursor

string

Opaque cursor for cursor-based pagination. Mutually exclusive with pageNumber and sinceCursor.

pageNumber

integer

Page number for classic pagination (1-indexed). Mutually exclusive with pageCursor and sinceCursor.

sinceCursor

string

Poll for items newer than this cursor value. Returns only items with a cursor greater than the provided value, ordered newest first. Designed for lightweight real-time polling — when no new items exist, the query returns immediately with zero results. The response includes latestCursor (the cursor of the newest returned item, or the original value if no results) for use in the next poll. Mutually exclusive with pageCursor and pageNumber.

hasSymbol

boolean

Filter to items where the issuer has a ticker symbol. Use hasSymbol=true to only return items with a symbol.

channel

string

Filter by distribution channel. Each channel corresponds to items categorized for specific distribution targets. Enterprise-only feature.

Allowed values: "app", "bot", "internal", "social", "widget"

Responses

200A page of RNS disclosure items

{
  "data": [DisclosureItem],
  "meta": Meta,
  "warnings": [string]
}

400Invalid filter or pagination parameters

{
  "error": ErrorDetail
}

401Invalid or missing API key

{
  "error": ErrorDetail
}

500Server error

{
  "error": ErrorDetail
}