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 da fonte

Publicador
DGII, Dominican Republic
Cobertura
Corporate RNC registrations; personal taxpayer identifiers are excluded.
Significado do 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.
Padrão aceito
^[14]\d{8}$
Quantidade de registros
one
Licença
A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

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

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

rncstringpathobrigatório

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

Example: 132159438

Exemplo de requisição

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

Respostas

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

Cabeçalhos da resposta

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 da resposta

rnc string obrigatório

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

legal_name string obrigatório

Registered name published by the authority.

economic_activity string obrigatório

Declared economic-activity description.

operations_start_date string obrigatório

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

status string obrigatório

Publisher status; not a Latinfo risk rating.

payment_regime string obrigatório

Official DGII payment regime.

Esquema de resposta
{
  "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.
Nenhum corpo de resposta documentado.
401Missing or invalid API key. Authenticate before retrying.
Nenhum corpo de resposta documentado.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
Nenhum corpo de resposta documentado.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
Nenhum corpo de resposta documentado.
503Source unavailable. Report unavailable, not an empty result.
Nenhum corpo de resposta documentado.
Exemplo JSON

Exemplo ilustrativo do esquema. Não é uma resposta ao vivo.

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

Procedência e limitações

A cobertura varia por país e fonte pública. Um campo ausente não comprova que o fato não exista. Os registros públicos podem ter atrasos ou erros; revise as evidências e a data da fonte antes de usar um resultado.