Documentacion API RNC y Cedula en Republica Dominicana
Esta guia explica como consultar contribuyentes por RNC, por nombre y en modo hibrido (nombre + cedula), con ejemplos listos para integrar en tus sistemas.
Base URL
https://api-dgii.dominicantechnology.com
Límite público general para consultas RNC: 100 solicitudes por día por IP.
Endpoints disponibles
- GET /api/v1/rnc/{rnc}: consulta directa por RNC o cedula sin guiones.
- GET /api/v1/buscar?q=texto: busqueda por razon social (minimo 3 caracteres). Si q es cedula valida (11 digitos), activa flujo hibrido.
- GET /api/v1/buscardgi?q=texto: busqueda por razon social (minimo 4 caracteres).
- POST /api/v1/private/cedula: consulta privada de cedula (requiere header X-API-Key).
- GET /api/v1/private/estadisticas: resumen de consumo por API Key.
Proteccion anti-abuso
- Flujo hibrido de cedula en nodo publico: 15 consultas por dia por IP.
- /api/v1/buscar: limite adicional para evitar saturacion por scraping masivo.
- /api/v1/buscardgi: limite estricto por minuto para proteger el origen DGII.
- Si se alcanza un limite, la API responde 429 con mensaje de reintento o enlace para solicitar API Key.
Ejemplo rapido
curl "https://api-dgii.dominicantechnology.com/api/v1/rnc/133626268"
Documentacion interactiva
Para probar los endpoints en vivo y ver el contrato OpenAPI completo, entra a Swagger.