Table of Contents

Table of Contents

minLevel	1
maxLevel	7

...

Company name
Type
Address
Contacts
Representatives
Shareholders
Beneficial owners

To access this API, you need to provide the following:

OAuth2 Access Tokens in each request.

...

- Please

...

- refer to the Authorization

...

- section to

...

- understand how to

...

- obtain the token

...

- .
Your Application-Id

...

- If you don’t have an Application

...

- -id, please contact support@ondato.com.

...

🔑 Authorization

Production: https://id.ondato.com/connect/token.
Sandbox: https://sandbox-id.ondato.com/connect/token

...

Key	Value	Description
`client_id`	<client_id>	Your ID that will be provided by Ondato.
`client_secret`	<secret>	Your secret that will be provided by Ondato.
`grant_type`	client_credentials	Machine-to-machine grant flow.
`scope`	<reuqested_scopes_separated_by_space>	Access to requested resources. Will be provided by Ondato.

Discovery endpoint

...

: https://id.ondato.com/.well-known/openid-configuration

...

🖥️ Authorization request example (production)

...

Code Block

curl --location --request POST 'https://id.ondato.com/connect/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={your client_id}' \
--data-urlencode 'client_secret=secret_that_only_you_know' \
--data-urlencode 'scope=registries_api'

...

☁️

...

Environments

Environment

Swagger URL

Base URL

Sandbox

https://sandbox-registries.ondato.com/swagger/index.html

https://sandbox-registries.ondato.com/

Prod

https://registries.ondato.com/swagger/index.html

https://registries.ondato.com

...

📍 Endpoint

This API consists of the following endpoint:

...

bgColor	#E3FCEF

...

:

Panel

bgColor	#E3FCEF

Status

colour	Green
title	post

/v1/legal/company-details - get detailed company information.

...

🚦 Request limit

Info

Check Please check the agreement to find your request limit.

If you cannot find it, please contact support@ondato.com.

...

🤙 Calling endpoint

Panel

bgColor	#E3FCEF

POST

Status

colour	Green
title	post

/v1/legal/company-details - get detailed company information.

...

Parameter

Type

Required

Description

1

Correlation-Id

stringNo

Status

title	no

A unique identifier assigned to the request.

2

Application-Id

stringYes

Status

title	yes

Your application Id.

Please contact support@ondato.com if you don’t have one.

3

Access token

string

Status

Yes

title	yes

Described in the Authentication part

4

useCache

string

Status

title

No

no

Request cached data of the company.

Possible values:

true (Default)
false

true - will return cached data of the company

false - will make a call to registry for actual data.

Panel

panelIconId	atlassian-info
panelIcon	:info:
bgColor	#F4F5F7

If parameter not provided, the cached data will be returned.

Caching logic explained in the section Data Caching.

...

Name

Description

Mandatory/Optional

1

country

ISO2 country code where the company is originated.

Accepted values:

LT | 🇱🇹
LV | 🇱🇻
EE | 🇪🇪
PL | 🇵🇱
GB | 🇬🇧

Status

colour	Red
title	MANDATORY

2

companyCode

Company code of the searched company.

Status

colour	Red
title	MANDATORY

3

useCache

Request chached data of the company.

Possible values:

true (Defaultdefault)
false

true -

- will return cached data of the company
false

-

- will make a call to registry for actual data.

Panel

panelIconId	atlassian-info
panelIcon	:info:
bgColor	#F4F5F7

If the parameter is not provided, the cached data will be returned.

Caching logic explained is detailed in the section Data Caching section.

Status

colour	Green
title	Optional

4

scopes

For Lithuanian companies data scope can be defined to return data only for selected objects. Data objects that were not selected will return Null value in the response.

Possible values (multiple values can be selected):

All (default)
GeneralInformation
Representatives
Shareholders
BeneficialOwners

This parameter will have no affect for effect on the response when requesting data for companies other than Lithuanian companiesthose in Lithuania.

Status

colour	Green
title	Optional

...

🗒️ Example

Expand

title	ExampleClick to view/close

Code Block

language	json

{
  "country": "LT",
  "companyCode": "303342439",
  "useCache": true,
  "scopes": [
    "GeneralInformation",
    "Representatives"]
}

...

Field

Description

Source of data

1

id

Unique Id of the response.

2

generalInformation

Block with general information about the company.

JAR

3

generalInformation.code

Company code.

4

generalInformation.name

Company name.

5

generalInformation.registeredDate

Date when company was registered.

6

generalInformation.type

Company type.

7

generalInformation.status

Company status.

8

generalInformation.address

Block with information about company address.

9

generalInformation.address.fullAddress

Full address of the company.

10

generalInformation.address.country

Country of the company's address.

11

generalInformation.address.flatNumber

Flat number of the company's address.

12

generalInformation.address.houseNumber

House number of the company's address.

13

generalInformation.address.city

City of the company's address.

14

generalInformation.address.street

Street of the company's address.

15

generalInformation.address.postCode

Post code of the company's address.

16

generalInformation.industry

Name of the industry company is part of.

17

generalInformation.contacts

Block of company's contacts.

18

generalInformation.contacts.type

Type of the contact.

Example: Email.

19

generalInformation.contacts.value

The contact.

20

beneficialOwners

Block with information about company's beneficial owners.

JANGIS

21

beneficialOwners.actualBeneficialOwners

Block with actual beneficial owners.

22

beneficialOwners.actualBeneficialOwners.subjectCode

Code of the beneficial owner.

For legal entity - company code;
For natural entity - personal code.

23

beneficialOwners.actualBeneficialOwners.companyName

Name of the company.

Info

If beneficial owner is a 🏛️ legal entity.

Otherwise field is empty and has value "null".

24

beneficialOwners.actualBeneficialOwners.fullName

Full name of the beneficial owner.

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

25

beneficialOwners.actualBeneficialOwners.firstName

First name of the beneficial owner.

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

26

beneficialOwners.actualBeneficialOwners.lastName

Last name of the beneficial owner.

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

27

dateOfBirth

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

28

documentCountryCode

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

29

documentCountryName

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

30

nationalityCountryCode

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

31

nationalityCountryName

Info

If beneficial owner is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

32

assetsControl

How many assets does natural or legal entity controls directly

33

votePercentage

Percentage of votes that beneficial owners have

34

beneficialOwners.actualBeneficialOwners.dateRegisteredFrom

Date when beneficial owner was registered.

35

beneficialOwners.actualBeneficialOwners.relationshipTypes

Relationship type of the beneficial owner. It describes how beneficial owner relates to the company.

36

beneficialOwners.actualBeneficialOwners.natureOfControl

Nature of control of the beneficial owner.

37

beneficialOwners.actualBeneficialOwners.countryCode

Country code of beneficial owners residence country

38

beneficialOwners.actualBeneficialOwners.countryName

Country of residence of the beneficial owner.

39

beneficialOwners.actualBeneficialOwners.ownershipPercent

Percentage of the shares beneficial owner holds in the company.

40

beneficialOwners.actualBeneficialOwners.owners

Block of higher level beneficial owners.

Info
The deepest level beneficialOwners.actualBeneficialOwners.owners blockcontains the Ultimate beneficial owner.

41

shareholders

Block with information about company shareholders.

JADIS

42

shareholders.actualShareholders

Block with actual shareholders.

43

shareholders.actualShareholders.firstName

First name of the shareholder.

Info

If shareholder is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

44

shareholders.actualShareholders.lastName

Last name of the shareholder.

Info

If shareholder is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

45

shareholders.actualShareholders.title

Name of the company.

Info

If shareholder is a 🏛️ legal entity.

Otherwise field is empty and has value "null".

46

shareholders.actualShareholders.type

Entity type of the shareholder.

Possible values are:

NaturalEntity
LegalEntity
ForeignNaturalEntity
ForeignLegalEntity
StateMunicipality
State
InvestmentFund.

47

shareholders.actualShareholders.typeDescription

Type of the shareholder.

Example: ,,Akcininkas”.

48

shareholders.actualShareholders.code

Code of the shareholder.

For legal entity - company code;
For natural entity - personal code.

49

shareholders.actualShareholders.address

Block with information about shareholder’s address.

50

shareholders.actualShareholders.address.fullAddress

Full address of the shareholder.

51

shareholders.actualShareholders.address.country

Country of the shareholder's address.

52

shareholders.actualShareholders.address.flatNumber

Flat number of the shareholder's address.

53

shareholders.actualShareholders.address.houseNumber

House number of the shareholder's address.

54

shareholders.actualShareholders.address.city

City of the shareholder's address.

55

shareholders.actualShareholders.address.street

Street of the shareholder's address.

56

shareholders.actualShareholders.address.postCode

Post code of the shareholder's address.

57

shareholders.actualShareholders.shares

Block with information about shareholder’s shares.

58

shareholders.actualShareholders.shares.typeDescription

Name of the share type.

59

shareholders.actualShareholders.shares.amount

Total amount of shares shareholder have.

60

shareholders.actualShareholders.shares.percent

Percentage of the shares shareholder holds in the company.

61

shareholders.actualShareholders.shares.pricePerShare

Block with information about share price.

62

shareholders.actualShareholders.shares.pricePerShare.value

Price for one share.

63

shareholders.actualShareholders.shares.pricePerShare.currency

Currency of the share price.

64

representatives

Block with information about company's representatives.

JAR

65

representatives.actualRepresentatives

Block with actual representatives.

66

representatives.actualRepresentatives.fullName

Full name of the representative.

Info

If representative is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

67

representatives.actualRepresentatives.firstName

First name of the representative.

Info

If representative is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

68

representatives.actualRepresentatives.lastName

Last name of the shareholder.

Info

If representative is a 🧑‍🦱 natural entity.

Otherwise field is empty and has value "null".

69

representatives.actualRepresentatives.title

Name of the company.

Info

If representative is a 🏛️ legal entity.

Otherwise field is empty and has value "null".

70

representatives.actualRepresentatives.code

Code of the representative.

For legal entity - company code;
For natural entity - personal code.

71

representatives.actualRepresentatives.birthDate

Date of birth of the representative.

72

representatives.actualRepresentatives.state

Name of representative’s country of residence.

73

representatives.actualRepresentatives.position

Representative’s position at the company.

74

representatives.actualRepresentatives.address

Block with information about representative’s address.

75

representatives.actualRepresentatives.address.fullAddress

Full address of the representative.

76

representatives.actualRepresentatives.address.country

Country of the representative’s address.

77

representatives.actualRepresentatives.address.flatNumber

Flat number of the representative’s address.

78

representatives.actualRepresentatives.address.houseNumber

House number of the representative’s address.

79

representatives.actualRepresentatives.address.city

City of the representative’s address.

80

representatives.actualRepresentatives.address.street

Street of the representative’s address.

81

representatives.actualRepresentatives.address.postCode

Post code of the representative’s address.

82

representatives.actualRepresentatives.type

Type of representative indicating that he/she is the head of the company.

Example: “Manager“.

83

representatives.actualRepresentatives.appointedOn

Date when representative was appointed.

84

representatives.actualRepresentatives.entityType

Entity type of the representative.

Possible values are:

NaturalEntity
LegalEntity.

85

representatives.actualRepresentatives.representationDescriptions

The description of representative role.

...

🗒️ Example

Expand

title	ExampleClick to view/close

Code Block

language	json

{
  "id": "60aa7002-7deb-4d1f-a6e3-d5ba51c5f0ac",
  "generalInformation": {
    "code": "303342439",
    "name": "UAB ONDATO",
    "registeredDate": "2014-07-03T00:00:00",
    "type": "Uždaroji akcinė bendrovė",
    "status": "Teisinis statusas neįregistruotas",
    "address": {
      "fullAddress": "Vilnius, Tolminkiemio g. 999-9",
      "country": "Lithuania",
      "flatNumber": "9",
      "houseNumber": "999",
      "city": "Vilnius",
      "street": "Tolminkiemio g.",
      "postCode": "LT11111"
    },
    "industry": "string",
    "contacts": [
      {
        "type": "Email",
        "value": "info@ondato.com"
      }
    ]
  },
  "beneficialOwners": {
    "actualBeneficialOwners": [
      {
        "subjectCode": "47702070740",
        "companyName": "ONDATO LTD",
        "firstName": "Jane",
        "lastName": "Doe",
        "dateRegisteredFrom": "2021-01-08T00:00:00",
        "relationshipTypes": [
          "Shareholder",
          "Member"
        ],
        "countryCode": "GB",
        "countryName": "United Kingdom",
        "ownershipPercent": "100",
        "owners": [
          "string"
        ]
      }
    ]
  },
  "shareholders": {
    "actualShareholders": [
      {
        "firstName": "Jane",
        "lastName": "Doe",
        "title": "ONDATO LTD",
        "type": "ForeignLegalEntity",
        "typeDescription": "Akcininkas",
        "code": "13018132",
        "address": {
          "fullAddress": "Vilnius, Tolminkiemio g. 999-9",
          "country": "Lithuania",
          "flatNumber": "9",
          "houseNumber": "999",
          "city": "Vilnius",
          "street": "Tolminkiemio g.",
          "postCode": "LT11111"
        },
        "shares": [
          {
            "typeDescription": "Vardinės paprastosios akcijos",
            "amount": 4125,
            "percent": 100,
            "pricePerShare": {
              "value": 2.9,
              "currency": "EUR"
            }
          }
        ]
      }
    ]
  },
  "representatives": {
    "actualRepresentatives": [
      {
        "fullName": "Jane Doe",
        "firstName": "Jane",
        "lastName": "Doe",
        "title": "ONDATO LTD",
        "code": "50001018865",
        "birthDate": "1985-05-05",
        "state": "Lietuvos Respublika",
        "position": "Narys",
        "address": {
          "fullAddress": "Vilnius, Tolminkiemio g. 999-9",
          "country": "Lithuania",
          "flatNumber": "9",
          "houseNumber": "999",
          "city": "Vilnius",
          "street": "Tolminkiemio g.",
          "postCode": "LT11111"
        },
        "type": "Manager",
        "appointedOn": "2022-01-05",
        "entityType": "NaturalEntity"
      }
    ]
  }
}

...

Drawio

mVer	2
zoom	1
simple	0
inComment	0
pageId	2346909759
custContentId	2408808696
lbox	1
diagramDisplayName	caching
contentVer	2
revision	2
baseUrl	https://ondato.atlassian.net/wiki
diagramName	caching
pCenter	0
width	951.0000000000001
links
tbstyle
height	581

We implement have implemented a data caching system for JAR, JAIDS, and JANGIS registry responses in our database. This system enables empowers our clients to choose select between receiving cached data or actual real-time data for a company.

...

⚙️ Caching Mechanism

Our caching mechanism stores responses from the JAR, JAIDS, and JANGIS registries in our database. We retain The cached data is retained for 24 hours, after following which it is automatically removed.

...

🛒 Retrieving Cached Data

If a client chooses in the request for requests cached company information, we our first step is to check if whether we have any cached data for the requested company from the JAR, JAIDS, or JANGIS registries acquired obtained within the last past 24 hours.

If we do have cached data available for the requested company, we return promptly deliver it to the client.

...

📥 Acquiring Actual Data

If we do not don't have cached data for the requested company, we will make a call to the relevant registry and acquire actual dataobtain the latest information.

...

👀 Monitoring Beneficial Owners (Pre-development version)

...

Drawio

mVer	2
zoom	1
simple	0
inComment	0
pageId	2346909759
custContentId	2413002778
lbox	1
diagramDisplayName	Untitled Diagram-1678801106325.drawio
contentVer	3
revision	3
baseUrl	https://ondato.atlassian.net/wiki
diagramName	Untitled Diagram-1678801106325.drawio
pCenter	0
width	1241
links
tbstyle
height	861

...

📍 Endpoint

To get the response of beneficial owner change you need to call this endpoint:GET

Status
colour Blue
title get
/events/vital/{companyCode}

...

🔠 Headers

Parameter

Type

Required

Description

companyCode

integerYES

Status

title	yes

The code of the company which has changes in its beneficial owners.

Application-Id

string

Status

title

YES

yes

Your application Id. Please contact support@ondato.com you don’t have one.

Access token

stringYES

Status

title	yes

Described in the Authentication part

...

Versions Compared

Old Version 57

New Version 58

Key

🔑 Authorization

🖥️ Authorization request example (production)

☁️

Environments

📍 Endpoint

🚦 Request limit

🤙 Calling endpoint

🗒️ Example

🗒️ Example

⚙️ Caching Mechanism

🛒 Retrieving Cached Data

📥 Acquiring Actual Data

👀 Monitoring Beneficial Owners (Pre-development version)

📍 Endpoint

🔠 Headers

Page Comparison

Versions Compared

Old Version 57

New Version 58

Key

🔑 Authorization

🖥️ Authorization request example (production)

☁️

Environments

📍 Endpoint

🚦 Request limit

🤙 Calling endpoint

🗒️ Example

🗒️ Example

⚙️ Caching Mechanism

🛒 Retrieving Cached Data

📥 Acquiring Actual Data

👀 Monitoring Beneficial Owners (Pre-development version)

📍 Endpoint

🔠 Headers