En directo
Estado del servicio
Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.
Identidad y verificación
API de validación de DNI, NIE y NIF españoles
Valida números de identidad y fiscales españoles en formularios, altas y facturación. La API reconoce DNI, NIE, números K, L y M y NIF de empresa, comprueba el carácter de control y devuelve el esperado cuando no coincide.
Categoría
Identidad y verificación
Endpoints
1
Características principales
4
Preguntas frecuentes
4
Utilizado por personas en estas empresas
Señales de confianza antes de integrar
Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.
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.
Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.
Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.
Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.
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 PostmanImporta solicitudes listas para pruebas manuales y traspaso al equipo.
SDKs y CLIUsa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.
Integración MCPExpó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ámetro
idcountry
Respuesta de ejemplo
countrynormalizedvalidtypeentity_typecheckschecks.formatchecks.controlexpected_controlerrors
Códigos de estado HTTP
200400401402429
Endpoints
GET
/v1/national-id/validate
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.
Características principales
Todos los tipos de número españoles
DNI, NIE, NIF K, L y M y NIF de empresa (antes CIF), cada uno reconocido con su propio formato y sus propias reglas de control.
Carácter de control esperado
Un último carácter erróneo se devuelve junto con el correcto, para que puedas sugerir la corrección a tu usuario.
Tipo de empresa
Los NIF de empresa devuelven el tipo de entidad y exigen que ese tipo termine en letra o en dígito, según corresponda.
Entrada tolerante
Se aceptan espacios, puntos, guiones, minúsculas, el prefijo ES y DNI de 7 cifras sin el cero inicial.
Solicitud de ejemplo
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=B58378431"Respuesta de ejemplo
{
"country": "ES",
"normalized": "B58378431",
"valid": true,
"type": "cif",
"entity_type": "sociedad_responsabilidad_limitada",
"checks": { "format": true, "control": true },
"expected_control": null,
"errors": []
}Preguntas frecuentes
¿Un resultado válido significa que la persona o la empresa existe?
No. La comprobación demuestra que el número está bien formado y tiene un carácter de control correcto. No demuestra que el número se haya expedido ni quién lo posee.
¿Puedo confirmar que una empresa española está registrada a efectos de VAT?
Sí. Envía el NIF con el prefijo ES a la API de validación de VAT, que lo comprueba en directo con el registro VAT de la UE.
¿Se almacenan o comparten datos?
No. La comprobación funciona sin conexión y el número nunca se envía a terceros.
¿Cuántos créditos cuesta?
Un crédito por número.
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
Validar un DNI