Tickerdevelopers

Disclosures schemas

Data models returned by Disclosures endpoints.

Category

{
  "kind": string<enum>,
  "code": string,
  "name": string,
  "description": string,
  "importance": string<enum>
}
kindstring<enum>

Category type

Allowed values: "Ticker", "FCA", "RNS"
codestring

Category code

namestring

Category name

descriptionstring

Category description (FCA only)

importancestring<enum>

Importance level (FCA only)

Allowed values: "low", "medium", "high", "ultra"

Company

{
  "name": string,
  "lei": string,
  "instrument": Instrument
}
namestring

Company name

leistring

Legal Entity Identifier

instrumentInstrument

Derivatives

Information derived from the announcement content

{
  "semanticHtml": {
    "url": string<uri>
  }
}
semanticHtmlobject

Token-optimised pure semantic HTML representation of the announcement. Only styles, layout, metadata, attributes and wasted nested tags are removed. All text information that materially makes the content of the announcement remains intact.

urlstring<uri>

URL to the semantic HTML document

DisclosureItem

{
  "rnsId": string,
  "timestamp": string<date-time>,
  "source": string,
  "guid": string,
  "version": integer,
  "issuer": Company,
  "related": [Company],
  "matchedBy": string<enum>,
  "headline": string,
  "category": [Category],
  "publication": [Publication],
  "derivatives": Derivatives,
  "replaces": any
}
rnsIdstring

Native RNS identifier

example: 1234W
timestampstring<date-time>

Publication timestamp

sourcestring

Source code

example: RNS
guidstring

Globally unique identifier

versioninteger

Version number (extracted from guid)

issuerCompany
matchedBystring<enum>

Why this item matched the requested identifier. issuer — published by that issuer, including former names and sibling listings. related — published by a different issuer, about the requested one. Present only when match=related was requested, which is the only mode returning both kinds in one list. Absent under match=issuer and match=exact, where every row is the same kind by construction. An item reached both ways is issuer: a company's own filing that also names itself in its subject tags is still its own filing. That is not an edge case — it is 68% of a typical issuer's results. Nothing else in the payload recovers this. related[] is a content annotation that also appears on an issuer's own filings, issuer.lei is null across most of the archive, and issuer.name varies in case between filings.

Allowed values: "issuer", "related"
headlinestring

Disclosure headline

category[Category]

Categories (Ticker and FCA)

publication[Publication]

Available document formats

derivativesDerivatives

Information derived from the announcement content

replacesany

If this is a replacement, details of the replaced announcement

Instrument

{
  "isin": string,
  "symbol": Symbol
}
isinstring

ISIN code

symbolSymbol

Publication

{
  "mime": string,
  "url": string
}
mimestring

MIME type

example: application/pdf
urlstring

URL to the document

Replaces

{
  "guid": string,
  "version": integer
}
guidstring

GUID of the replaced announcement

versioninteger

Version of the replaced announcement

Symbol

{
  "mnemonic": string
}
mnemonicstring

Ticker symbol