Skip to main content

Service Monitoring

Checking System Liveness

To check the liveness of our service, you can call a special function without side effects. This function only checks the basic server availability.

Method and URL

[GET] https://customer.identity.tm/api/2.10/serverStatus

HTTP Codes

200 Service available
500 Service not available
None Service not available

Checking System Status

The system continually monitors its own status. To query information, you can call this function at any time.

Please note, that the availability of mailing only reflects our internal mailing system. If you gave us an external mailing service to use, this service will not be monitored for you.

Furthermore, information about AES will only be available if your account has been configured to provide AES functionality.

Method and URL

[GET] https://customer.identity.tm/api/2.10/systemStatus

Response Data

ElementParentTypeLenOccDescription
serverAlive[ROOT]BYServers are running
apiAvailable[ROOT]BYCustomer API working
videoAvailable[ROOT]BYVideo system working
mailingAvailable[ROOT]BYMail-System available
smsTanAvailable[ROOT]BYSMS TAN working
autoIdentAvailable[ROOT]BDepIDnow AutoIdent servers alive

Only if enabled
assureIdAvailable[ROOT]BDepAssureID servers alive

Only if enabled
readIdAvailable[ROOT]BDepReadID servers alive

Only if enabled
iProovAvailable[ROOT]BDepiProov servers alive

Only if enabled
eSign[ROOT]ODepOnly if eSign is enabled
serverAliveeSignBDepQES servers alive
qesAvailableeSignBDepQES systems working
fesServerAliveeSignBDepAES servers alive
fesAvailableeSignBDepAES systems working

HTTP Codes

200 OK, JSON document in body

401 Authentication failed, please check username and password

500 Services not available at all

None Services not available at all

Example Request

[GET] https://customer.identity.tm/api/2.10/systemStatus

Example Response

{
"serverAlive": true,
"apiAvailable": true,
"videoAvailable": true,
"mailingAvailable": true,
"smsTanAvailable": true,
"eSign": {
"serverAlive": true,
"qesAvailable": true,
"fesServerAlive": true,
"fesAvailable": true
}
}