Dominican Republic · do_dgii_rnc_contribuyentes_rnc
OpenAPI

Lookup dgii · rnc-contribuyentes by RNC

GET https://api.latinfo.dev/do/dgii/rnc-contribuyentes/rnc/{rnc}

A corporate taxpayer registration with declared activity and payment regime. Coverage: Corporate RNC registrations; personal taxpayer identifiers are excluded. Lookup by rnc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. A taxpayer registration is not a certificate of tax clearance. Returns one record. Import time is not observation time; inspect freshness headers.

Contrato de la fuente

Publicador
DGII, Dominican Republic
Cobertura
Corporate RNC registrations; personal taxpayer identifiers are excluded.
Qué representa un registro
A corporate taxpayer registration with declared activity and payment regime.
Identificador
Lookup by rnc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido
^[14]\d{8}$
Cantidad de registros
one
Licencia
No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

  • A taxpayer registration is not a certificate of tax clearance.

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

rncstringpathobligatorio

RNC in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: 132159438

Ejemplo de solicitud

curl https://api.latinfo.dev/do/dgii/rnc-contribuyentes/rnc/132159438 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Published source records. Missing data is not a clearance or a negative finding.

Encabezados de la respuesta

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

Content-Type: application/json

Campos de la respuesta

rnc string obligatorio

Lookup by rnc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

legal_name string obligatorio

Registered name published by the authority.

economic_activity string obligatorio

Declared economic-activity description.

operations_start_date string obligatorio

Published operations start date date. Format: DD/MM/YYYY.

status string obligatorio

Publisher status; not a Latinfo risk rating.

payment_regime string obligatorio

Official DGII payment regime.

Esquema de respuesta
{
  "type": "object",
  "properties": {
    "rnc": {
      "type": "string",
      "description": "Lookup by rnc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "legal_name": {
      "type": "string",
      "description": "Registered name published by the authority.",
      "x-latinfo-meaning": "text"
    },
    "economic_activity": {
      "type": "string",
      "description": "Declared economic-activity description.",
      "x-latinfo-meaning": "text"
    },
    "operations_start_date": {
      "type": "string",
      "description": "Published operations start date date. Format: DD/MM/YYYY.",
      "x-latinfo-meaning": "date"
    },
    "status": {
      "type": "string",
      "description": "Publisher status; not a Latinfo risk rating.",
      "x-latinfo-meaning": "text"
    },
    "payment_regime": {
      "type": "string",
      "description": "Official DGII payment regime.",
      "x-latinfo-meaning": "text"
    }
  },
  "required": [
    "rnc",
    "legal_name",
    "economic_activity",
    "operations_start_date",
    "status",
    "payment_regime"
  ],
  "additionalProperties": false
}
400Invalid identifier or query. Correct the input before retrying.
No se documentó un cuerpo de respuesta.
401Missing or invalid API key. Authenticate before retrying.
No se documentó un cuerpo de respuesta.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No se documentó un cuerpo de respuesta.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No se documentó un cuerpo de respuesta.
503Source unavailable. Report unavailable, not an empty result.
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

{
  "rnc": "string",
  "legal_name": "string",
  "economic_activity": "string",
  "operations_start_date": "string",
  "status": "string",
  "payment_regime": "string"
}

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.