API para Desarrolladores
Ofrecemos una API REST pública y gratuita para consultar el Registro Nacional de Contribuyentes (RNC) de la DGII de República Dominicana. Ideal para integrar verificación de RNC en tus aplicaciones, sistemas contables, ERPs o cualquier proyecto.
Actualización de Datos
La base de datos del RNC se actualiza automáticamente cada día en la madrugada con la información más reciente publicada por la DGII. Esto garantiza que las consultas reflejen los datos oficiales más actualizados disponibles.
Documentación Interactiva (Swagger)
Explora y prueba todos los endpoints directamente desde la documentación interactiva de Swagger. Puedes ejecutar consultas en tiempo real sin necesidad de escribir código.
Abrir Swagger UIURL Base
http://62.146.171.39:8086/api/DGIITodas las peticiones son GET y devuelven JSON. No se requiere autenticación ni API key.
Endpoints Disponibles
/api/DGII/{rnc}Busca un contribuyente por su número de RNC o cédula. Devuelve un resultado exacto.
Ejemplo de uso
GET http://62.146.171.39:8086/api/DGII/132790316Respuesta exitosa
{
"rnc": "132790316",
"nombreCompleto": "OSCARSOFT SRL",
"nombreComercial": "OSCARSOFT",
"actividad": "PLANIFICACIÓN Y DISEÑO DE LOS",
"fechaRegistro": "14/11/2022",
"estado": "ACTIVO",
"categoria": "RST"
}/api/DGII/GetByName/{nombre}Busca un contribuyente por su nombre exacto (razón social completa).
Ejemplo de uso
GET http://62.146.171.39:8086/api/DGII/GetByName/OscarsoftRespuesta exitosa
{
"rnc": "132790316",
"nombreCompleto": "OSCARSOFT SRL",
"nombreComercial": "OSCARSOFT",
"actividad": "PLANIFICACIÓN Y DISEÑO DE LOS",
"fechaRegistro": "14/11/2022",
"estado": "ACTIVO",
"categoria": "RST"
}/api/DGII/search/{criterio}Busca contribuyentes que coincidan con el criterio de búsqueda. Retorna hasta 10 resultados.
Ejemplo de uso
GET http://62.146.171.39:8086/api/DGII/search/OscarsofRespuesta exitosa
[
{
"rnc": "132790316",
"nombreCompleto": "OSCARSOFT SRL",
"nombreComercial": "OSCARSOFT",
"actividad": "PLANIFICACIÓN Y DISEÑO DE LOS",
"fechaRegistro": "14/11/2022",
"estado": "ACTIVO",
"categoria": "RST"
},
...
]Campos de Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| rnc | string | Número de RNC o cédula |
| nombreCompleto | string | Razón social o nombre completo |
| nombreComercial | string | Nombre comercial del negocio |
| actividad | string | Actividad económica registrada |
| fechaRegistro | string | Fecha de registro (DD/MM/YYYY) |
| estado | string | Estado del contribuyente (ACTIVO, SUSPENDIDO, etc.) |
| categoria | string | Categoría tributaria (NORMAL, RST, etc.) |
Ejemplos de Integración
JavaScript / Fetch
const response = await fetch(
'http://62.146.171.39:8086/api/DGII/132790316'
);
const data = await response.json();
console.log(data.nombreCompleto); // "OSCARSOFT SRL"Python
import requests
response = requests.get(
'http://62.146.171.39:8086/api/DGII/132790316'
)
data = response.json()
print(data['nombreCompleto']) # "OSCARSOFT SRL"cURL
curl http://62.146.171.39:8086/api/DGII/132790316C# / .NET
using var client = new HttpClient();
var response = await client.GetAsync(
"http://62.146.171.39:8086/api/DGII/132790316"
);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);Notas Importantes
Gratuita y sin límites: La API es actualmente gratuita y de uso libre. No se requiere registro ni API key para usarla.
Datos públicos: La información proviene de la base de datos pública de la DGII. Puede haber caracteres especiales (ñ, tildes) con encoding no estándar en algunos registros.
Datos siempre frescos: La base de datos se sincroniza automáticamente con la DGII cada madrugada. Además, es posible forzar una actualización manual a través de la API cuando se requiera información al instante.
Uso responsable: Pedimos que hagas un uso responsable de la API. Evita hacer miles de peticiones por minuto. Si necesitas datos masivos, contáctanos.
¿Preguntas o sugerencias?
Contáctanos para reportar problemas, solicitar nuevos endpoints o colaborar.
[email protected]