Skip to main content
API docs by Redocly

dmss-authentication-service (24.0.22)

Download OpenAPI specification:Download

TrustLynx: sales@trustlynx.com URL: https://trustlynx.com

web-eid-auth-controller

web-eid-auth-controller : authenticate

Web-Eid authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

Request Body schema: application/json
required
algorithm
required
string

The algorithm used to produce the authentication signature

signature
required
string

web-eid plugin generated signature (The base64-encoded signature of the token)

unverifiedCertificate
required
string

The public key contained in this certificate should be used to verify the signature

format
string

The type identifier and version of the token format (current value: web-eid:1.0)

Responses

Request samples

Content type
application/json
{
  • "unverifiedCertificate": "string",
  • "signature": "string",
  • "algorithm": "string",
  • "format": "string"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

web-eid-auth-controller : authenticate_1

Web-Eid authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

origin
required
string
Request Body schema: application/json
required
algorithm
required
string

The algorithm used to produce the authentication signature

signature
required
string

web-eid plugin generated signature (The base64-encoded signature of the token)

unverifiedCertificate
required
string

The public key contained in this certificate should be used to verify the signature

format
string

The type identifier and version of the token format (current value: web-eid:1.0)

Responses

Request samples

Content type
application/json
{
  • "unverifiedCertificate": "string",
  • "signature": "string",
  • "algorithm": "string",
  • "format": "string"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

web-eid-auth-controller : challenge

Web-Eid authentication start request

Responses

Response samples

Content type
application/json
{
  • "sessionCode": "8460",
  • "nonce": "string"
}

sms-auth-controller

sms-auth-controller : sendSms

SMS Authentication request for sending SMS with code

Request Body schema: application/json
required
country
required
string
Example: "LV"

ISO country code "+"

phoneNumber
required
string
Example: "37112345678"

Phone number with country code without "+"

Responses

Request samples

Content type
application/json
{
  • "country": "LV",
  • "phoneNumber": "37112345678"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "session": "string",
  • "expiresIn": 0,
  • "result": "string"
}

sms-auth-controller : sendCode

Send OTP request for server-side verification

Request Body schema: application/json
required
otp
required
string
Example: "123456"

Received OTP in SMS

sessionCode
required
string

Session code generated after sending SMS

Responses

Request samples

Content type
application/json
{
  • "otp": "123456",
  • "sessionCode": "string"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "personalCode": "string",
  • "country": "string",
  • "result": "string"
}

smart-id-auth-controller

smart-id-auth-controller : authenticate

Smart-ID authentication start request

Request Body schema: application/json
required
personalCode
required
string
Example: "30303039914"

Person personal code

country
string
Enum: "EE" "LT" "LV" "EU"

Person origin identity 2 character ISO 3166-1 alpha-2 country code (valid values: EE, LV, LT)

displayText
string
Example: "This is additional Text"

Display text shown on mobile application up to 60 characters

displayTextLong
string
Example: "This is additional Text LOOONG"

Display text shown on mobile application up to 200 characters, used by newer versions of Smart-ID mobile applications. If value not specified use "displayText" value

synch
boolean
Example: "false"

Use synchronous request to Smart-ID or not, default is asynchronous

Responses

Request samples

Content type
application/json
{
  • "country": "EE",
  • "displayText": "This is additional Text",
  • "displayTextLong": "This is additional Text LOOONG",
  • "synch": false,
  • "personalCode": "30303039914"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "null",
  • "lastName": "null",
  • "personalCode": "null",
  • "sessionCode": "5fd1bd86-b6ca-46fa-8adf-c457c0dc7350",
  • "verificationCode": "8460",
  • "phoneNumber": "null",
  • "result": "AUTHENTICATION_STARTED"
}

smart-id-auth-controller : getAuthenticationSessionStatus

Smart-ID authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

shaulia-bank-controller

shaulia-bank-auth-controller : shauliaBankAuthentication

Request Body schema: application/json
required
src
string
time
string
personCode
string
firstName
string
lastName
string
signature
string
type
string
object
algorithm
string

Responses

Request samples

Content type
application/json
{
  • "src": "string",
  • "time": "string",
  • "personCode": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "signature": "string",
  • "type": "string",
  • "publicKey": {
    • "encoded": "string",
    • "format": "string",
    • "algorithm": "string"
    },
  • "algorithm": "string"
}

shaulia-bank-auth-controller : shauliaBankAuthentication_1

query Parameters
code
required
string
execution
required
string
tabId
required
string
clientId
required
string

Responses

otp-controller

otp-auth-controller : otpVerify

Request Body schema: application/json
required
otpCode
required
string
Example: "00112200"
provider
required
string
Value: "EUROCERT"
Example: "EUROCERT"
sessionCode
required
string
Example: "1a074cc1-13ac-476b-95a9-a81f8a64465f"

Responses

Request samples

Content type
application/json
{
  • "sessionCode": "1a074cc1-13ac-476b-95a9-a81f8a64465f",
  • "otpCode": "00112200",
  • "provider": "EUROCERT"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

otp-auth-controller : otpLogin

Request Body schema: application/json
required
login
required
string
Example: "trustlunx@eurocert.pl"
password
required
string
provider
required
string
Value: "EUROCERT"
Example: "EUROCERT"

Responses

Request samples

Content type
application/json
{
  • "login": "trustlunx@eurocert.pl",
  • "password": "string",
  • "provider": "EUROCERT"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "null",
  • "lastName": "null",
  • "personalCode": "null",
  • "sessionCode": "5fd1bd86-b6ca-46fa-8adf-c457c0dc7350",
  • "verificationCode": "8460",
  • "phoneNumber": "null",
  • "result": "AUTHENTICATION_STARTED"
}

mobile-id-auth-controller

mobile-id-auth-controller : authenticate

Mobile-ID authentication start request

Request Body schema: application/json
required
personalCode
required
string
Example: "30303039914"

Person personal code

phoneNumber
required
string
Example: "+37112344321"

Person mobile phone

language
string
Example: "EE"

Person origin identity

displayText
string
Example: "This is a Text"

Display text shown on mobile application up to 60 characters

Responses

Request samples

Content type
application/json
{
  • "phoneNumber": "+37112344321",
  • "personalCode": "30303039914",
  • "language": "EE",
  • "displayText": "This is a Text"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "null",
  • "lastName": "null",
  • "personalCode": "null",
  • "sessionCode": "5fd1bd86-b6ca-46fa-8adf-c457c0dc7350",
  • "verificationCode": "8460",
  • "phoneNumber": "null",
  • "result": "AUTHENTICATION_STARTED"
}

mobile-id-auth-controller : getAuthenticationSessionStatus

Mobile-ID authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

lvrtc-banking-api-auth-controller

lvrtc-banking-api-auth-controller : authenticate

LVRTC Banking API authentication start request

Request Body schema: application/json
required
personalCode
required
string
Example: "390101-00001"

Person personal code

displayText
string
Example: "This is additional Text"

Message displayed to the user to prompt them to authorize. Up to 300 characters of text.

forcePin
boolean
Example: "false"

Request to use PIN code, biometrics not allowed.

Responses

Request samples

Content type
application/json
{
  • "displayText": "This is additional Text",
  • "forcePin": false,
  • "personalCode": "390101-00001"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "null",
  • "lastName": "null",
  • "personalCode": "null",
  • "sessionCode": "5fd1bd86-b6ca-46fa-8adf-c457c0dc7350",
  • "verificationCode": "8460",
  • "phoneNumber": "null",
  • "result": "AUTHENTICATION_STARTED"
}

lvrtc-banking-api-auth-controller : getAuthenticationSessionStatus

LvRtc Banking API authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

identt-controller

identt-auth-controller : identtAuthentication

Request Body schema: application/json
required
string

Responses

Request samples

Content type
application/json
"string"

Response samples

Content type
application/json
{
  • "personalNumber": "string",
  • "surname": "string",
  • "givenNames": "string",
  • "country": "string",
  • "stateContext": {
    • "code": "string",
    • "execution": "string",
    • "tabId": "string",
    • "clientId": "string"
    },
  • "execution": "string",
  • "tabId": "string",
  • "clientId": "string",
  • "valid": true,
  • "errorDescription": "string"
}

identt-auth-controller : identtAuthentication_1

Responses

Response samples

Content type
application/json
{
  • "personalNumber": "string",
  • "surname": "string",
  • "givenNames": "string",
  • "country": "string",
  • "stateContext": {
    • "code": "string",
    • "execution": "string",
    • "tabId": "string",
    • "clientId": "string"
    },
  • "execution": "string",
  • "tabId": "string",
  • "clientId": "string",
  • "valid": true,
  • "errorDescription": "string"
}

identt-auth-controller : identtAuthentication_2

query Parameters
code
string
execution
string
tabId
string
clientId
string

Responses

Response samples

Content type
application/json
{
  • "documentId": "string",
  • "sessionId": "string",
  • "verifyBaseUrl": "string",
  • "responseUrl": "string",
  • "stateSessionId": "string",
  • "redirectUrl": "string"
}

evro-trust-controller

evro-trust-controller : authenticate

Evro Trust authentication start request

Request Body schema: application/json
required
country
string
Enum: "EE" "LT" "LV" "EU"

Person origin identity 2 character ISO 3166-1 alpha-2 country code (valid values: EE, LV, LT)

identificationNumber
string
Example: "30303039914"

Person personal code

email
string
Example: "test@test.com"

Person e-mail

phone
string
Example: "+37112344321"

Person phone number

Responses

Request samples

Content type
application/json
{
  • "country": "EE",
  • "identificationNumber": "30303039914",
  • "email": "test@test.com",
  • "phone": "+37112344321"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "null",
  • "lastName": "null",
  • "personalCode": "null",
  • "sessionCode": "5fd1bd86-b6ca-46fa-8adf-c457c0dc7350",
  • "verificationCode": "8460",
  • "phoneNumber": "null",
  • "result": "AUTHENTICATION_STARTED"
}

evro-trust-controller : getAuthenticationSessionStatus

Evro Trust authentication status poll request

path Parameters
session
required
string
Example: 5fd1bd86-b6ca-46fa-8adf-c457c0dc7350

Authentication session code from authentication start request response

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

certificate-controller

certificate-controller : authenticate

Request Body schema: application/json
required
certInHex
required
string

x509 SSL certificate in the HEX format

country
string
Enum: "EE" "LT" "LV" "EU"

Person origin identity 2 character ISO 3166-1 alpha-2 country code (valid values: EE, LV, LT)

Responses

Request samples

Content type
application/json
{
  • "certInHex": "string",
  • "country": "EE"
}

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

oauth-2-auth-controller

oauth2-auth-controller : startAuthentication

path Parameters
provider
required
string

Oauth2 provider, current supported: zealid, lvrtc, asseco

query Parameters
redirect_uri
string

Redirect URI to the Service provider's application.

state
string

We recommend using this parameter to safeguard against CSRF attacks. To do this, the Service provider’s application must include a random value in this parameter, store it in the HTTP session and verify it when the Authorization Response message is received.

Responses

getAuthenticationResult

path Parameters
provider
required
string
query Parameters
code
required
string
Example: code=a0daddc2e35c44cde87555c332d5918e39eca2f5262a121d053397bf140798d2

The authorization code received in the previous authorization response.

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

lvrtc-auth-controller

lvrtc-auth-controller : startAuthentication

query Parameters
return_url
string
Default: ""

Redirect URI to the Service provider's application.

locale
string
Default: ""
Example: locale=lv

Specifies a list of languages ordered by preference

acr_values
string
Default: ""
Example: acr_values=urn:eparaksts:authentication:flow:mobileid

Defines conditions for authenticating the end-user (minimum levels or specific flows) who must authorize the access.

state
string
Default: ""

We recommend using this parameter to safeguard against CSRF attacks. To do this, the Service provider’s application must include a random value in this parameter, store it in the HTTP session and verify it when the Authorization Response message is received.

Responses

getAuthenticationResult_1

query Parameters
code
required
string
Example: code=a0daddc2e35c44cde87555c332d5918e39eca2f5262a121d053397bf140798d2

The authorization code received in the previous authorization response.

return_url
string
Default: ""

Redirect URI to the Service provider's application.

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "ok",
  • "firstName": "QUALIFIED OK1",
  • "lastName": "TESTNUMBER",
  • "personalCode": "30303039914",
  • "country": "EE",
  • "documentNumber": "PNOEE-30303039914-5QSV-Q",
  • "age": 118,
  • "dateOfBirth": "1903-03-03",
  • "phoneNumber": "12344321",
  • "email": "test@test.com",
  • "result": "AUTHENTICATION_STARTED"
}

lvrtc-auth-controller : logOut

query Parameters
return_url
string
Default: ""

Redirect URI to the Service provider's application.

Responses

lt-id-controller

lt-id-auth-controller : LTIDAuthentication

query Parameters
personCode
required
string
controlCode
required
string

Responses

Response samples

Content type
application/json
{
  • "firstName": "string",
  • "lastName": "string",
  • "personCode": "string"
}

citadele-controller

citadele-auth-controller : citadeleAuthentication

query Parameters
xmlData
required
string

Responses

Response samples

Content type
application/json
{
  • "personCode": "string",
  • "personCountry": "string",
  • "firstName": "string",
  • "lastName": "string"
}

citadele-bank-auth-controller : CitadeleAuthentication

query Parameters
code
required
string
execution
required
string
tabId
required
string
country
required
string
clientId
required
string

Responses

Response samples

Content type
application/json
"string"

ama-controller

amaauth-controller : amaAuthentication

query Parameters
state
required
string

Responses

Response samples

Content type
application/json
"string"

amaauth-controller : amaAuthentication_1

query Parameters
token
required
string

Responses

Response samples

Content type
application/json
[
  • {
    • "name": "string",
    • "value": "string",
    • "state": "string"
    }
]