Documentación de la API de RNC y cédula
Consulta el padrón de contribuyentes de la DGII de República Dominicana por RNC, por razón social o por cédula. Hay rutas públicas para probar sin registro y rutas privadas que aplican el plan de tu API Key.
Inicio rápido
Base URL
https://api-dgii.dominicantechnology.com
Todas las respuestas son JSON con UTF-8. No hace falta enviar Accept.
Autenticación
La API Key va siempre en el header X-API-Key. Esa misma key
identifica al cliente y determina su plan, sus capacidades y sus cupos. No hay tokens de sesión ni
OAuth.
Rutas públicas
Abiertas para evaluar el servicio, con un cupo de 5 consultas por día y por IP. Si envías una API Key válida, manda tu plan en lugar del cupo por IP.
Rutas privadas
Bajo /api/v1/private/. Exigen API Key y que tu plan incluya
la capacidad del endpoint. Consíguela gratis en tu panel.
Probador en vivo
Lanza una consulta real contra el nodo desde aquí. Sin API Key usa el cupo público; si pegas tu key, se aplica tu plan.
Endpoints
Cada endpoint privado exige una capacidad concreta. Si tu plan
no la incluye, la respuesta es 403 feature_no_incluida e
indica qué te falta.
Planes y límites
No hay jerarquía de niveles: cada plan declara qué capacidades incluye y cuántas consultas permite. Esta tabla se lee en vivo del servidor, así que siempre muestra los precios y cupos vigentes.
Cada respuesta incluye los headers X-Plan, X-RateLimit-Remaining-Day y X-RateLimit-Remaining-Month. Tu consumo en vivo está en Mi cuenta.
Respuestas de error
| Código | Error | Qué significa |
|---|---|---|
| 401 | API Key requerida | Falta la key en una ruta privada, o fue revocada. |
| 403 | feature_no_incluida | Tu plan no incluye esa capacidad. El JSON indica
feature_requerida. |
| 429 | limite_diario_excedido | Agotaste el cupo del día. Se reinicia cada jornada. |
| 429 | limite_mensual_excedido | Agotaste el cupo del mes. Se reinicia el día 1. |
| 429 | limite_anonimo_alcanzado | Agotaste las 5 consultas diarias sin API Key. |
| 404 | no_encontrado | El RNC o la cédula no existe en el padrón. |
{
"error": "feature_no_incluida",
"feature_requerida": "cedula_lookup",
"plan": "business",
"features_disponibles": ["rnc_lookup", "buscar_nombre"],
"upgrade_url": "https://wa.me/18492208954"
}Referencia OpenAPI
El contrato completo, con todos los esquemas de respuesta y la posibilidad de ejecutar peticiones. Es el mismo Swagger de /docs, montado aquí para no tener la guía y la referencia en dos sitios distintos.
Descargas
Manuales y documentos en PDF publicados por el equipo.
Preguntas frecuentes
¿Necesito una API Key para consultar un RNC? +
No para probar. Las rutas públicas responden sin API Key con un cupo reducido por IP. Para integrar la API en un sistema necesitas una API Key gratuita, que se obtiene creando una cuenta en el panel.
¿Cómo se autentica una petición? +
Enviando la API Key en el header
X-API-Key. La misma key determina el plan, las
capacidades y los límites del cliente.
¿Qué diferencia hay entre RNC y cédula? +
El RNC identifica a una empresa o
contribuyente y devuelve razón social y estado. La cédula identifica a una persona física y
devuelve su nombre, fecha de nacimiento, sexo y nacionalidad, por lo que exige un plan con la capacidad
cedula_lookup. Una cédula de 11 dígitos consultada por
las rutas de RNC también la exige.
¿Qué pasa cuando agoto mi límite? +
La API responde 429 con
limite_diario_excedido o
limite_mensual_excedido. Los headers
X-RateLimit-Remaining-Day y
X-RateLimit-Remaining-Month permiten anticiparlo.
¿Los datos vienen de la DGII? +
Sí. La búsqueda en vivo consulta el origen de la DGII en el momento de la petición, y las consultas por RNC se sirven desde el padrón de contribuyentes actualizado.
¿Listo para integrar?
Crea tu cuenta, copia tu API Key y haz la primera consulta en menos de un minuto. El plan gratuito no caduca.