API Documentation

Authentication

All API requests require authentication via API key in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

Address Validation API

POST /v1/validate/address

Request Body

{
  "address_line1": "123 main st",
  "city": "dubai",
  "state": "",
  "postal_code": "",
  "country": "AE"
}

Response

{
  "is_valid": true,
  "normalized": {
    "address_line1": "123 Main St",
    "city": "Dubai",
    "state": "",
    "postal_code": "",
    "country": "AE"
  },
  "confidence": 0.92
}

Phone Validation API

POST /v1/validate/phone

Request Body

{
  "phone": "0501234567",
  "country": "AE"
}

Response

{
  "is_valid": true,
  "e164": "+971501234567",
  "country": "AE",
  "type": "mobile"
}

Email Risk Detection API

POST /v1/validate/email

Request Body

{
  "email": "test@tempmail.com"
}

Response

{
  "is_valid": true,
  "is_disposable": true,
  "risk_level": "high"
}

Rate Limits

Rate limits are enforced per plan:

  • Free: 500 calls/month
  • Starter: 20,000 calls/month
  • Growth: 100,000 calls/month
  • Scale: 500,000 calls/month

Error Codes

401 - Invalid API key
429 - Rate limit exceeded
500 - Server error