SIM Swap Check

e-verify provides real-time SIM swap detection across major South African mobile network operators (Vodacom, MTN). This service helps prevent fraud by identifying if a subscriber's SIM card has been recently swapped, which is a common indicator of identity theft.

Endpoint

POST /v1/sim-swap/check

Request Body

Field	Type	Description	Required
phone_number	string	The phone number to check for SIM swap.	Yes

Example Request

POST /v1/sim-swap/check 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_simswap_1234567890",
  "status": "completed",
  "result": {
    "sim_swapped": true,
    "last_swap_date": "2024-07-20T10:00:00Z",
    "risk_level": "high"
  },
  "message": "SIM swap check completed successfully."
}

Error Codes

Code	Description
400	Invalid input data
401	Unauthorized
403	Forbidden
404	Phone number not found
500	Internal server error