Base URL #

Authentication #

For each request to Email Validator API is required to provide authentication using the API key generated in the Aktiva Email Validator dashboard. You can pass the API key in the request header in the Authorization section.

Example using cURL #

curl -H 'Authorization: <API_KEY>' -X GET https://api-validator.aktiva.co.id/app/v1/validate/single

Responses #

All data are sent by the API using JSON format. Each response sent from the API contains a status parameter with the value either “Success” or “Failed” indicating whether the request is successful or not.

Success Response Example #

HTTP/1.1 200 OK
{
    "msg": "Success validate single email",
    "status": "Success",
    "statusCode": 200,
    "data": {
        "detail": {
            "disposableEmail": false,
            "domainStatus": true,
            "email": "r@richi.my.id",
            "emailFormat": true,
            "emailType": "Profesional",
            "openRelay": true,
            "result": "risky",
            "roleEmail": false,
            "serverStatus": true,
            "timestamp": "2024-05-13T15:35:36.800651+07:00",
            "validationType": "advance"
        },
        "email": "r@richi.my.id",
        "type": "advance",
        "uuid": "50d035b8-c9bc-4cb1-91c0-64db8a2b687c",
        "valid": "risky"
    }
}

Error Response Example #

HTTP/1.1 401 Unauthorized

{
    "msg": "Not authorized",
    "status": "Failed",
    "statusCode": 401,
    "data": {
        "msg": "not authorized to access this route"
    }
}

HTTP Status Codes #