Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Table of Contents

ℹ️ Introduction

This Registries API endpoint returns a natural person’s data from the country’s population registry. Currently, only the Lithuanian Population registry (Gyventojų registras - GR) is supported.

...

🛂 Authentication

An access token must be included in the request to access the API. You can obtain an access token by following the instructions provided here.

The API has one scope: registries_population_api, which provides access to the natural person validation endpoint.

...

☁️ Environments

The API has two environments: Sandbox and Prod. The base URLs and the available scopes for each environment are provided in the table below. Additionally, the Swagger URL for the API is also provided.

Environment

Swagger URL

Base URL

Scopes

Sandbox

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

https://sandbox-registries.ondato.com

registries_population_api

Prod

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

https://registries.ondato.com

registries_population_api

...

😶‍🌫️ Endpoints

Info

Status
colourGreen
titlePOST
/v1/natural/population

...

🔠 Headers

Parameter

Type

Required

Description

Correlation-Id

string

No

A unique identifier assigned to the request.

Application-Id

string

YES

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

Access token

string

YES

Described in the Authentication part

...

🎯 Request body

Field

Type

Description

personalCode

string

National identification number of the person. Personal code (asmens kodas) in Lithuania.
Examples (sandbox):
50001018865
38710079999
38505019999

documentType

string

Person’s document type.
Optional parameter. If it is not provided then data is returned of the last issued document ignoring the type.

countryCode

string

Country code in ISO 3166-1 alpha-2 format.
Example: LT for Lithuania

...

💠 Swagger

Swagger open api macro
displayOperationIdfalse
methodsnone,get,put,post,delete,options,head,patch,trace
validator
defaultModelsExpandDepth0
urlhttps://registries.ondato.com/swagger/v1/swagger.json
token
defaultModelRenderingexample
filterPopulation
password
expandlist
showCommonExtensionsfalse
filename
operations
maxDisplayedTags
attachfalse
displayRequestDurationshowExtensionsfalse
showExtensionsdisplayRequestDurationfalse
username
order

...

💳 Billing

Info

For billing details please contact

...

billing@ondato.com

...