Codigos de error

La API utiliza codigos de estado HTTP estandar y devuelve respuestas de error en formato JSON.

Codigos de estado HTTP

Codigo	Significado	Descripcion
200	OK	Solicitud exitosa
400	Bad Request	Parametros ausentes o invalidos
401	Unauthorized	API key ausente o invalida
403	Forbidden	La API key no tiene acceso
404	Not Found	El endpoint no existe
429	Too Many Requests	Limite de tasa o cuota excedidos
500	Internal Server Error	Algo salio mal en nuestro lado
503	Service Unavailable	Servicio dependiente temporalmente no disponible

Formato de respuesta de error

Todas las respuestas de error siguen un formato consistente:

{
  "error": "Description of the error",
  "status": 400
}

Errores comunes

API Key ausente

curl https://api.iqxlookup.neivi.es/api/v1/email?address=test@example.com

{
  "error": "Missing X-Api-Key header",
  "status": 401
}

Parametros invalidos

curl -H "X-Api-Key: ALk-your-key" \
  "https://api.iqxlookup.neivi.es/api/v1/email"

{
  "error": "Parameter 'address' is required",
  "status": 400
}

Limite de tasa excedido

{
  "error": "Rate limit exceeded",
  "retryAfter": 42,
  "status": 429
}