Version 1 Actualizado 2026-03-17

Documentación API

Nuestra API es rápida y fácil de integrar — puedes estar funcionando en menos de 15 minutos. Además, obtienes 50 solicitudes gratuitas cada día para comenzar.

Conceptos básicos

Todas las solicitudes a la API deben enviarse utilizando el método POST. El endpoint base para todas las solicitudes es:

https://numvalid.com/api/v1/[api_key]

Reemplaza [api_key] con tu clave de API personal. Todos los parámetros de la solicitud deben enviarse en el cuerpo de la petición como JSON. Puedes obtener tu clave de API en tu panel de control después de registrarte.

Prueba

Método: test

Este método se utiliza para probar la conexión con la API. Verifica que tu clave de API sea válida y que el servicio esté disponible. Si todo está configurado correctamente, la API devolverá una respuesta exitosa.

Ejemplo de solicitud

{
    "method": "test"
}

Respuesta exitosa

{
  "error": 0,
  "message": "Yippee-ki-yay"
}

Campos de la respuesta
error — código de error (0 significa que la solicitud fue exitosa)
message — mensaje de respuesta de la API

Información

Método: info

El método info devuelve información sobre tu cuenta y la suscripción actual, incluyendo el número de solicitudes de API utilizadas.

Ejemplo de solicitud

{
    "method": "info"
}

Respuesta exitosa

{
    "error": 0,
    "name": "John",
    "surname": "Smith",
    "email": "[email protected]",
    "subscription": "Growth",
    "count_request": 2349
}

Campos de la respuesta
error — código de error (0 significa que la solicitud fue exitosa)
name — nombre del propietario de la cuenta
surname — apellido del propietario de la cuenta
email — correo electrónico de la cuenta
subscription — plan de suscripción actual
count_request — número de solicitudes de API utilizadas en el período de suscripción actual

Verificación

Método: verify

El método verify comprueba un número de teléfono y devuelve información detallada de validación.

Los números de teléfono pueden proporcionarse en cualquier formato. La API maneja automáticamente caracteres como (, ), -, + y espacios.

Ejemplo de solicitud

{
  "phone": "491609502065",
  "method": "verify"
}

Respuesta exitosa

{
  "error": 0,
  "request_phone": "491609502065",
  "valid_phone": true,
  "type": "mobile",
  "format": {
    "local": "01609502065",
    "international": "+491609502065"
  },
  "country": {
    "code": "DE",
    "name": "Germany (Federal Republic of)",
    "prefix": "+49"
  },
  "requests": {
    "subscription": "Growth",
    "count": 2,
    "start": "2026-04-06 10:29:40",
    "finish": "2026-10-06 10:29:40",
    "limit": 9000
  }
}

Campos de la respuesta
error — código de error (0 significa que la solicitud fue exitosa)
request_phone — número de teléfono enviado en la solicitud
valid_phone — resultado de la validación (true si el número es válido)
type — tipo de número de teléfono (por ejemplo, móvil, fijo, etc.)

Objeto de formato
local — número de teléfono en formato local
international — número de teléfono en formato internacional

Objeto de país
code — código ISO del país
name — nombre del país
prefix — prefijo de marcación internacional

Objeto de solicitudes
Información sobre el uso actual de tu suscripción.
subscription — plan de suscripción activo
count — número de solicitudes ya utilizadas
start — fecha de inicio del período de suscripción
finish — fecha de finalización del período de suscripción
limit — número máximo de solicitudes permitidas en el período de suscripción

¿Preguntas sobre nuestra documentación?

¿Tienes preguntas sobre nuestra documentación de API? Contáctanos:

Contactar con soporte