Quickstart

Get an API key

Create one in the dashboard under API keys. You will see the full key exactly once — store it as a secret.

All API keys are live keys. Verification is free, with no limit on checks.

Make a call

Send the key as a bearer token and the value in the body:

curl https://api.menaverify.com/v1/verify/phone \
  -H "Authorization: Bearer $MENAVERIFY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": "+971 50 123 4567"}'

Every verify endpoint also accepts GET with a value query parameter, which is handy for a quick check from a terminal:

curl "https://api.menaverify.com/v1/verify/phone?value=%2B971501234567" \
  -H "Authorization: Bearer $MENAVERIFY_KEY"

Read the result

{
  "type": "phone",
  "valid": true,
  "input": "+971 50 123 4567",
  "normalized": "+971501234567",
  "country": { "code": "AE", "name": "United Arab Emirates" },
  "details": { "line_type": "mobile", "carrier": { "name": "Etisalat" } }
}

Branch on valid, store normalized, and show reason when you need to explain a rejection. The full contract is in Reading a result.