VALOR

GET/v0/valor

Validates a VALOR (Valorennummer, also: Valoren number) — the numeric identifier assigned by SIX Financial Information (SIX Group, Zurich) to Swiss and Liechtenstein securities. A VALOR consists of 5 to 9 digits (/^\d{5,9}$/). Unlike ISIN, CUSIP, or SEDOL, the VALOR has no check digit — validation is purely format-based. Whitespace and leading zeros are handled automatically.

VALORs are embedded in Swiss and Liechtenstein ISINs: the NSIN of a CH… or LI… ISIN is the VALOR zero-padded to 9 characters. For example, ISIN CH0012138530 contains VALOR 1213853 (NSIN 001213853).

When the VALOR is structurally valid, the endpoint queries OpenFIGI (Bloomberg) using idType: ID_VALOR to retrieve instrument details. Results are cached for 24 hours.

Guides: Node.js · Python

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The VALOR to validate (5–9 digits, e.g. `1213853`). Leading zeros are stripped automatically if the result still has at least 5 digits.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/valor?value=1213853"

Response Fields

Field	Type	Description
valid	boolean	Whether the value is a valid 5–9 digit VALOR
valor	string	The normalised (whitespace-stripped, leading-zeros-removed) VALOR
found	boolean \| null	Whether the instrument was found in OpenFIGI. `true` — found, instrument details included; `false` — structurally valid VALOR but not found in OpenFIGI; `null` — OpenFIGI unavailable, structural validation result only
dataSource	string	Always `openfigi` when present. Present only when `found` is `true`
isin	string \| null	ISIN associated with this VALOR as returned by OpenFIGI (e.g. `CH0012138530`). Present when `found` is `true`; `null` if not returned
name	string \| null	Full instrument name (e.g. `UBS Group AG`). Present when `found` is `true`
ticker	string \| null	Exchange ticker symbol. From OpenFIGI; `null` if not provided
exchCode	string \| null	Bloomberg exchange code (e.g. `SE` for SIX Swiss Exchange). From OpenFIGI; `null` if not provided
securityType	string \| null	Security type from OpenFIGI (e.g. `Common Stock`). From OpenFIGI; `null` if not provided
marketSector	string \| null	Market sector from OpenFIGI (e.g. `Equity`). From OpenFIGI; `null` if not provided
figi	string \| null	Financial Instrument Global Identifier. From OpenFIGI; `null` if not provided
compositeFIGI	string \| null	Composite FIGI representing the instrument across all exchanges. From OpenFIGI; `null` if not provided

Example Response — found

{
  "valid": true,
  "valor": "1213853",
  "found": true,
  "dataSource": "openfigi",
  "isin": "CH0012138530",
  "name": "UBS Group AG",
  "ticker": "UBSG",
  "exchCode": "SE",
  "securityType": "Common Stock",
  "marketSector": "Equity",
  "figi": "BBG000BVD464",
  "compositeFIGI": "BBG000BVD464"
}

Example Response — not found

{
  "valid": true,
  "valor": "1213853",
  "found": false
}

Example Response — invalid

{
  "valid": false
}