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.

HTTP API Request Authentication​

API endpoint​

Verigator API requests are made to following server:

https://api.verigator.com/

Authentication​

Authentication is done by setting HTTP header "X-Service-Auth" to your Messente API username and password concatenated with semicolon like this:

X-Service-Auth: messente-api-username:messente-api-password

Request and response body​

All request and response bodys for the API calls are JSON encoded strings according to the specification.

Response HTTP status codes​

API call responses have status codes according to REST specifications. Always set Accept and Content-Type headers to application/json as well. Only 2XX response codes indicate successful response.

Example request​

$ curl -X POST \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'X-Service-Auth: uXXwRLJOaCifV:oA5rVSvslkcoXK' \
    --data '{"method": "totp"}' \
    'https://api.verigator.com/v1/service/402339fa-624a-11e7-907b-a6006ad3dba0/users/57166678-624a-11e7-907b-a6006ad3dba0/auth'