API de inteligencia y validación de números de teléfono

Categoría Seguridad

Endpoints 2

Características principales 7

Preguntas frecuentes 6

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

phonedefault_countryexpected_countrydialing_from_countrylanguagephones

Campos de respuesta

Respuesta de ejemplo

inputnormalized_inputkindvalidpossiblestatusrecommendationvalidation_levelreasonwarningsnumbernumber.e164

Cobertura de estados

Códigos de estado HTTP

200400401402429500502503504

Endpoints

POST /v1/phone/validate

Créditos: 1Autenticación: Autenticación requerida

phonedefault_countryexpected_countrydialing_from_countrylanguage

POST /v1/phone/validate/bulk

Créditos: 1Autenticación: Autenticación requerida

phonesdefault_countryexpected_countrydialing_from_countrylanguage

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

Estado del servicio Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

Créditos gratuitos Regístrate Gratis

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Activo Solicitud de ejemplo

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Características principales

Validación estricta del plan de numeración

Comprueba la longitud y los patrones de dígitos con metadatos completos del plan de numeración, no solo la longitud.

Formatos normalizados

Devuelve los formatos E.164, internacional, nacional y RFC 3966, incluidas las extensiones analizadas.

Posible frente a válido

Distingue los números con una longitud plausible de los rangos reconocidos por el plan de numeración.

Tipo de número e inteligencia del prefijo

Identifica el tipo de número, la ubicación según el plan de numeración, posibles zonas horarias, el operador original del prefijo y la compatibilidad con la portabilidad cuando los metadatos lo permiten.

Marcación y números cortos según el país

Analiza números nacionales con un país, genera formatos de marcación según el país de origen y reconoce números cortos regionales y números de emergencia.

Validación masiva

Valida hasta 100 números por solicitud con un resultado individual para cada entrada.

Fuentes sin conexión y asignaciones oficiales

Utiliza metadatos sin conexión y copias públicas de datos de reguladores en la infraestructura de DomScan. Los resultados coincidentes incluyen la fuente, la licencia, la fecha de actualización y el contexto de la asignación original.

Solicitud de ejemplo

POST /v1/phone/validate bash

curl -X POST https://domscan.net/v1/phone/validate \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+34 612 345 678","expected_country":"ES","dialing_from_country":"US","language":"en"}'

Respuesta de ejemplo

200 OK json

{
  "input": "+34 612 345 678",
  "normalized_input": "+34 612 345 678",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": null,
  "warnings": [],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": ["ES"],
    "country_match": true,
    "type": "mobile",
    "non_geographic": false
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "coverage": {
      "country": "ES",
      "level": "official_allocation_match",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": ["cnmc"],
      "matching_source_ids": ["cnmc"],
      "current_carrier_lookup": false
    },
    "location": {
      "country_name": "Spain",
      "country": "ES",
      "granularity": "country",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": ["Europe/Madrid"],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "source_id": "cnmc",
      "evidence": "official_allocation_record",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "internationally_diallable": true
    },
    "regulator_allocations": [{
      "authority": "CNMC",
      "category": "mobile",
      "status": "assigned",
      "original_assignee": "FOOTBALLERISTA MOBILE SPAIN, S.A. UNIPERSONAL",
      "assigned_on": "2023-11-03",
      "current_operator": false,
      "individual_number_assignment_checked": false
    }],
    "sources": [{
      "id": "google_libphonenumber",
      "name": "Google libphonenumber metadata",
      "license": "Apache-2.0"
    }, {
      "id": "cnmc",
      "name": "Comisión Nacional de los Mercados y la Competencia (CNMC)",
      "type": "official_regulator_snapshot"
    }]
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "limitations": [
    "NUMBERING_PLAN_ONLY",
    "DOES_NOT_PROVE_ASSIGNMENT",
    "NO_LIVE_TELECOM_CHECKS"
  ],
  "credits_used": 1
}

Preguntas frecuentes

¿Qué significa que un número de teléfono sea válido?

Válido significa que el número coincide con la longitud y los patrones de dígitos documentados de un rango reconocido del plan de numeración. No significa que el número esté asignado a un abonado.

¿La validación demuestra que el número está activo o accesible?

No. La validación del plan de numeración no puede confirmar que un número esté asignado, activo, accesible o que pueda recibir llamadas o SMS.

¿La API devuelve el operador actual o el titular del teléfono?

La API puede devolver el operador original del prefijo o el titular de la asignación del regulador. Ninguno de estos campos indica el operador actual después de una portabilidad ni identifica al abonado o al titular del teléfono.

¿Los números de teléfono nacionales requieren un país?

Sí. Indica un país o región predeterminado cuando el número no comience por un prefijo telefónico internacional. También se necesita un país para interpretar números cortos regionales y números de emergencia.

¿De dónde proceden los datos de inteligencia?

Los metadatos mundiales proceden de Google libphonenumber. Los datos oficiales sobre rangos y prefijos también pueden proceder de copias públicas publicadas por CNMC, ARCEP, Bundesnetzagentur, MIC Japón, RTR Austria, Nkom, UKE Polonia, MODA Taiwán, NANPA para Estados Unidos y CNA/CNAC para Canadá. Los registros de Estados Unidos y Canadá describen el estado de los códigos de central NPA-NXX y sus titulares originales, no el operador actual de un número portado. Cada resultado indica sus fuentes, las fechas de las copias y el nivel de cobertura. La ubicación y las zonas horarias describen el prefijo del plan de numeración, no la posición actual del teléfono.

¿Puedo validar números de teléfono de forma masiva?

Sí. El endpoint masivo acepta hasta 100 números y devuelve los resultados en el orden de entrada. Si el enriquecimiento sin conexión no está disponible, la validación local se completa igualmente e intelligence.status indica la degradación.

Herramientas y Recursos Relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Error del servidor 500

Error interno

Puerta de enlace incorrecta 502

Error del servicio RDAP de origen

Servicio no disponible 503

El servicio ascendente no está disponible o está limitando temporalmente.

Tiempo de espera de la puerta de enlace agotado 504

La consulta al servicio de origen agotó el tiempo de espera.

Prueba gratis la inteligencia de números de teléfono

Ver documentación completa de la API APIs

API de inteligencia de números de teléfono

Señales de confianza antes de integrar

Qué te ayuda a lanzar esta API

Flujo de integración

Kit para desarrolladores

Mapa de parámetros y respuesta

Endpoints

Señales de confianza antes de integrar

Características principales

Solicitud de ejemplo

Respuesta de ejemplo

Preguntas frecuentes

Herramientas y Recursos Relacionados

Códigos de estado HTTP