Identidad y verificación

API de validación de números VAT

Comprueba los números VAT de tus clientes en el pago o en el alta. Los números de la UE y de Irlanda del Norte se comprueban en directo con el registro VAT de la UE y los noruegos con el registro mercantil de Noruega, con el nombre y la dirección registrados cuando el país los divulga.

Ver documentación Probar la herramienta gratuita Explorar todas las API

Endpoints Activo

GET /v1/vat/validate

Solicitud de ejemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Respuesta de ejemplo 200 OK

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registe
...

Solicitud de ejemplo GET /v1/vat/validate

Características principales 4

Preguntas frecuentes 4

Códigos de estado HTTP 200 / 400 / 401 / 402 / 429

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.

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

vatcountryrequester

Campos de respuesta

Respuesta de ejemplo

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/vat/validate

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

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

Comprobaciones en directo en el registro

La validez procede del registro oficial en el momento en que consultas, no de una lista en caché ni solo de una comprobación de formato.

Prueba de tu comprobación

Envía tu propio número VAT de la UE como solicitante para recibir un número de consulta que puedes conservar como prueba para la facturación con inversión del sujeto pasivo.

Primero formato y dígitos de control

Los números mal formados se rechazan sin consultar el registro, y los dígitos de control se informan para todos los países admitidos.

Desconocido, nunca no válido

Cuando un registro nacional está fuera de servicio u ocupado, el resultado es desconocido con el motivo, y la solicitud no se cobra.

Solicitud de ejemplo

GET /v1/vat/validate?vat=NO923609016MVA bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

Respuesta de ejemplo

200 OK json

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}

Preguntas frecuentes

¿Qué países se cubren?

Los 27 países de la UE e Irlanda del Norte se comprueban en directo, al igual que Noruega. Los números del Reino Unido, Suiza y Australia se comprueban en cuanto a formato y dígitos de control, porque esos registros no ofrecen una consulta pública gratuita.

¿Por qué falta el nombre de la empresa?

Algunos países, como Alemania y España, no divulgan nombres ni direcciones a través del registro de la UE. En ese caso, el resultado establece name_disclosed en false.

¿Qué significa desconocido?

El registro no pudo dar una respuesta: no estaba disponible, estaba ocupado o tardó demasiado. Reintenta más tarde. Los resultados desconocidos se reembolsan.

¿Cuántos créditos cuesta?

Un crédito por comprobación. Las comprobaciones que terminan como desconocidas no se cobran.

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 número VAT

Empezar gratis Ver documentación Probar la herramienta gratuita