API REST gratuita y con CORS habilitado para sistemas POS, facturación electrónica (e-CF / NCF) y aplicaciones web o móviles. Última actualización: 2026-11-07 · 797,960 registros.
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/rnc/:rnc | Consulta exacta de RNC (9 dígitos, formato oficial X-XX-XXXXX-X) o Cédula (11 dígitos), con o sin guiones. |
| GET | /api/v1/search?q=... | Búsqueda parcial por Razón Social o Nombre Comercial (estado y limit de 1 a 25 opcionales). |
| POST / GET | /api/v1/rnc/batch | Resuelve hasta 100 RNC/Cédulas (POST JSON o GET ?rncs=id1,id2). |
| GET | /api/v1/meta | Totales del padrón y fecha de última actualización sincronizada. |
| GET | /health | Estado operativo y disponibilidad del servicio. |
Usa estos identificadores de prueba reservados para verificar tu conexión sin consultar contribuyentes reales. Devuelven
isTestExample: true e isActive: false:
GET https://rnc.urbanstockpos.com/api/v1/rnc/000000000 GET https://rnc.urbanstockpos.com/api/v1/rnc/00000000000 GET https://rnc.urbanstockpos.com/api/v1/search?q=EMPRESA%20DE%20PRUEBA GET https://rnc.urbanstockpos.com/api/v1/rnc/batch?rncs=00000000000,000000000
200 OK)
Al integrar facturación con NCF o comprobantes electrónicos (e-CF), valida que data.isActive === true antes de emitir crédito fiscal:
{
"ok": true,
"found": true,
"data": {
"rnc": "000000000",
"formattedRnc": "0-00-00000-0",
"tipoDocumento": "RNC",
"razonSocial": "EMPRESA DE PRUEBA URBANSTOCK SRL",
"nombreComercial": "COMERCIO EJEMPLO (TEST)",
"actividadEconomica": "REGISTRO SINTÉTICO DE PRUEBA PARA DEMOSTRACIÓN E INTEGRACIÓN API (NO REAL)",
"fechaInicio": "01/01/2026",
"estado": "PRUEBA (TEST)",
"isActive": false,
"regimenPago": "DEMO",
"isTestExample": true
},
"meta": {
"padronFecha": "2026-11-07",
"datasetVersion": 2,
"cached": false,
"coalesced": false,
"isTestExample": true
}
}
ETag y Cache-Control; puedes enviar If-None-Match para recibir 304 Not Modified sin descargar el JSON nuevamente.200 encontrado, 400 formato inválido, 404 no existe en el padrón, 429 límite de frecuencia excedido (revisa Retry-After), 503 sincronización inicial en curso.X-API-Key.