Skip to main content

Authentication

All API endpoints require authentication via an API key.

API Key

Include your API key in the X-Api-Key header:

curl -H "X-Api-Key: YOUR_API_KEY" \
"https://api.iqxlookup.neivi.es/api/v1/email?address=user@example.com"
Header only

The API key must be sent via the X-Api-Key header. Query parameter authentication is not supported.

Obtaining an API Key

  1. Log in to the IQX Lookup Dashboard
  2. Navigate to API Tokens
  3. Click Create Token and provide a label
  4. Copy the generated token value — it won't be shown again

Security

  • All API traffic is encrypted via HTTPS/TLS
  • API keys follow the format: ALk- followed by 36 alphanumeric characters
  • You can create multiple tokens for different applications
  • Revoke tokens instantly from the dashboard
  • Regenerate tokens if compromised

Error Responses

HTTP StatusMeaning
401Missing API key
403API key is inactive or revoked
429Rate limit or quota exceeded