IDs
Most endpoints require an ID to be specified in the request. All entities in a data set have a unique ID.
Moody's Version IDs
In the Moody's version, BvD-IDs are used as IDs. BvD-IDs consist of a two-letter upper-case ISO country code followed by digits and possibly a few special letters.
- For legal persons, the string following the country code is often some kind of national ID, but this varies from country to country.
- If the country is not known,
YYis used as country code for legal persons andWWfor individuals. - If the third character of the BvD-ID is a
*, it means that this entity is only known from shareholder data, and that the ID is more likely to change in the future.
OrbisId
As an alternative to BvD-IDs, legal entities might also be looked up by OrbisId. The syntax is the same as for BvD-IDs, except that an OrbisId must be prefixed by orbisid:.
Examples fetching the beneficial owners of T-rank:
1. /api/v2/beneficial/NO990092397?model=integrated,vp&threshold_integrated=>25
2. /api/v2/beneficial/orbisid:036797576?model=integrated,vp&threshold_integrated=>25
Tieto Version IDs
In the Tieto version, IDs are built from upper-case two-letter ISO country code, followed by one of the following:
- Legal Person: The national ID.
- For Finnish companies, leading zeros and the dash have been removed before creating the ID (e.g.,
0123456-7becomesFI1234567). In order to generate the national id from our IDs, leftpad with zeros to get 8 digits, then insert a dash between the second last and last digit.
- For Finnish companies, leading zeros and the dash have been removed before creating the ID (e.g.,
- Natural Person:
P+ internal T-rank ID. - Unidentified Entity:
X+ internal T-rank ID (could be legal or natural person). - Estate/Property (Norway only):
E+join('-', Municipality ID, Cadastral unit number, Property unit number, Lease number, Unit number).
For natural persons and unidentified entities, the country code refers to the source of information and not necessarily the country of incorporation/residence/citizenship. For the latter, see the country/citizenship entity attributes. If a shareholder from e.g. the Norwegian data has been linked to an Swedish entity in the Swedish data, the Swedish (SE) ID will be used.