Phone Number Validation

e-verify provides phone number validation to verify the authenticity and type of phone numbers across major South African carriers. This helps in maintaining accurate contact information and reducing communication failures.

Endpoint

POST /v1/validate/phone

Request Body

Field	Type	Description	Required
phone_number	string	The phone number to validate (e.g., +27821234567).	Yes

Example Request

POST /v1/validate/phone HTTP/1.1
Host: api.e-verify.co.za
X-API-Key: ev_live_YOUR_API_KEY
Content-Type: application/json

{
  "phone_number": "+27821234567"
}

Response

{
  "request_id": "req_phone_1234567890",
  "status": "completed",
  "result": {
    "phone_number": "+27821234567",
    "is_valid": true,
    "country_code": "ZA",
    "line_type": "mobile",
    "carrier": "Vodacom",
    "is_reachable": true
  },
  "message": "Phone number validation completed successfully."
}

Error Codes

Code	Description
400	Invalid input data
401	Unauthorized
403	Forbidden
500	Internal server error