Skip to main content

Verification API Documentation


Deprecation Notice

The API has been deprecated. Looking to build a one-time phone verification? Use our Number Verification API instead for a more flexible solution.

Service Setup

When starting with Verification API you will first need to register your Service to get a unique ServiceID that will be later used to add and verify your users.

You may have multiple separate web services using the same Messente account, therefore you can create multiple Services and receive multiple ServiceID's in the process.

Request to register a service will be made to the following URL:

POST https://api.verigator.com/v1/service/service

Request headers

HTTP headerDescriptionRequired
Content-Type
application/json
Accept
application/json
X-Service-Auth
Refer to authentication section on how to authenticate your API calls with Messente API username and password

Request body (JSON encoded)

KeyDescriptionRequired
fqdn
Fully Qualified Domain Name, for example: coffeeshop.com or dashboard.service.com
name
Name of your service, that will appear as the issuer in the Verigator app. Example: CoffeeShop

Response body (JSON encoded)

KeyDescription
id
Newly created ServiceID. You will need to store this in your Verigator API configuration.Example: 81213bfd-b690-499e-b9d2-8754cb1550e8
name
Name of the Service as provided in request body. Example: CoffeeShop
ctime
Datetime of the created service in RFC 3339 specification. Example: 2017-07-06T13:12:03.141Z

HTTP Response Codes

Status codeValueDescription
201
Created
Service successfully created
401
Authentication required
Missing authentication headers (X-Service-Auth)
403
Forbidden
Forbidden request
404
Not found
409
Conflict
Service already exists
422
Invalid data
Invalid request body - check the format and if it was correctly JSON encoded