RNC API: consulta del padrón de contribuyentes
Consulta desde tu sistema el padrón de contribuyentes por RNC, cédula o nombre. Cada respuesta dice de qué fecha es el dato. Un servicio de Villar JA sobre el listado público de la DGII.
# Consulta un RNC del padrón ficticio del sandbox
curl https://rnc.villarja.com/v1/taxpayers/900000001 \
-H "Authorization: Bearer rnc_sbx_…"
# → 200
{
"rnc": "900000001",
"legalName": "EMPRESA FICTICIA ACTIVA, SRL",
"commercialName": "FICTICIA ACTIVA",
"status": "ACTIVO",
"category": null,
"regime": "NORMAL",
"economicActivity": "SERVICIOS DE PRUEBA",
"startDate": "2001-05-14",
"dataAsOf": "2026-01-01",
"source": "sandbox"
}- Estado
- Próximamente
- Consulta
- RNC, cédula o nombre
- Fuente
- Listado público de la DGII
- Para empezar
- Plan gratis y sandbox
Lo que tu sistema necesita para validar un cliente
Identidad
RNC o cédula, razón social y nombre comercial.
Situación
Estado en el padrón (activo, suspendido, dado de baja…), categoría y régimen.
Actividad
Actividad económica registrada y fecha de inicio de operaciones.
Frescura
La fecha del padrón de la que sale el dato y su fuente, en cada respuesta.
De la primera prueba a producción, con la misma API
Paso 1: Crea tu cuenta y tu clave
En el portal de autoservicio, con plan gratis para empezar.
Paso 2: Prueba en el sandbox
Un padrón ficticio fijo para integrar sin gastar consultas.
Paso 3: Consulta en producción
La misma API con tu clave de producción y el consumo a la vista.
Lo que debes saber
De dónde sale el dato
Del listado público de contribuyentes que publica la DGII, actualizado cada mes. No es un servicio oficial de la DGII.
Personas físicas
La consulta por número devuelve el contribuyente que corresponda. La búsqueda por nombre solo devuelve personas jurídicas.
Planes y cobro
Planes mensuales o anuales con cupo de consultas, cobrados en dólares por PayPal. Los precios se publican al abrir el servicio.
Si te pasas del cupo
Te avisamos y la velocidad se reduce hasta el siguiente periodo. Tu sistema no se queda sin respuesta de golpe.
Dudas habituales
¿Es un servicio oficial de la DGII?
No. Es un servicio de Villar JA construido sobre el listado público de la DGII. Cada respuesta indica la fecha del padrón usado.
¿Qué tan actualizado está?
El padrón se sincroniza cada mes con el listado de la DGII y vigilamos que la sincronización termine bien.
¿Puedo buscar personas por nombre?
No. La búsqueda por nombre solo devuelve personas jurídicas. Una cédula concreta se consulta por su número.
¿Cuándo estará disponible?
Estamos terminando el portal y el cobro. Escríbenos y te avisamos en cuanto abra, con acceso al sandbox.
¿Cuánto cuesta?
Habrá un plan gratis para empezar y planes de pago según el volumen de consultas. Publicaremos los precios al abrir.
Te avisamos cuando abra
Cuéntanos qué necesitas consultar y cuántas consultas esperas al mes. Escríbenos a ventas@villarja.com o por WhatsApp.