GET /v1/dgii/document/{document}

Consulta exacta de un contribuyente DGII por RNC (9 u 11 dígitos) o Cédula (11 dígitos con guiones opcionales).

Parámetros de ruta

Param	Tipo	Descripción
document	string	RNC o Cédula. Se acepta con o sin guiones.

Headers requeridos

Header	Descripción
x-api-key	API key sandbox/producción

Respuestas

200 — Contribuyente encontrado

{
  "rnc": "130862346",
  "name": "DIRECCIÓN GENERAL DE IMPUESTOS INTERNOS",
  "trade_name": "DGII",
  "economic_activity": "ADMINISTRACIÓN PÚBLICA EN GENERAL",
  "status": "ACTIVO",
  "payment_regime": "ORDINARIO"
}

400 — Formato inválido

{
  "type": "https://api.erply.pro/errors/invalid-document-format",
  "title": "Bad Request",
  "status": 400,
  "detail": "Document must be a valid RNC (9 or 11 digits) or Cédula."
}

404 — No encontrado

{
  "type": "https://api.erply.pro/errors/document-not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "No registry entry for document 999999999."
}

Ejemplo cURL

curl -s https://api.erply.pro/v1/dgii/document/130862346 \
  -H "x-api-key: $ERPLYPRO_API_KEY"

Ejemplos de código

Ver ejemplos multi-lenguaje (Python, JavaScript, C#, PHP, Go) y la colección Postman.

Notas

• La respuesta es cacheable (Cache-Control: public, max-age=300).
• El header X-Registry-Run-Id indica la ejecución de ingest que produjo el dato.
• Si el registro fue purgado (Ley 172-13), retorna 404 sin revelar que existió.