Lookup sri · padron by RUC

GET https://api.latinfo.dev/ec/sri/padron/ruc/{ruc}

A taxpayer registration with principal-establishment geography and activity. Coverage: Corporate RUCs in the published SRI province files. Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. The principal-establishment location is not a list of every branch. Returns one record. Import time is not observation time; inspect freshness headers.

Contrato de la fuente

Publicador: Servicio de Rentas Internas, Ecuador
Cobertura: Corporate RUCs in the published SRI province files.
Qué representa un registro: A taxpayer registration with principal-establishment geography and activity.
Identificador: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido: ^\d{13}$
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

The principal-establishment location is not a list of every branch.

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

rucstringpathobligatorio

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

Example: 1793025048001

Ejemplo de solicitud

curl https://api.latinfo.dev/ec/sri/padron/ruc/1793025048001 \
  -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

ruc string obligatorio

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

razon_social string obligatorio

Registered legal name.

estado string obligatorio

Publisher status; interpret in the context of this dataset.

ACTIVO · PASIVO · SUSPENDIDO

Significado de los valores

TAX_REGISTRATION

ACTIVO

Active: SRI reports the taxpayer registration as active.

PASIVO

Inactive: SRI reports the taxpayer registration as passive, meaning it is not currently active.

SUSPENDIDO

Suspended: SRI reports the taxpayer registration as suspended.

nombre_fantasia string obligatorio

Published trade name; may be absent.

actividad_economica string obligatorio

Published economic-activity description.

codigo_ciiu string obligatorio

Published CIIU economic-activity code.

fecha_inicio_actividades string obligatorio

Published fecha inicio actividades date. Format: YYYY-MM-DD HH:mm:ss.

fecha_suspension string obligatorio

Published fecha suspension date. Format: YYYY-MM-DD HH:mm:ss.

fecha_actualizacion string obligatorio

Published fecha actualizacion date. Format: YYYY-MM-DD HH:mm:ss.

obligado_contabilidad string obligatorio

S/N: whether accounting books are required.

agente_retencion string obligatorio

S/N: published withholding-agent designation.

contribuyente_especial string obligatorio

S/N: published special-taxpayer designation.

provincia string obligatorio

Published province name.

canton string obligatorio

Province subdivision of the principal establishment.

parroquia string obligatorio

Parish of the principal establishment.

Esquema de respuesta

{
  "type": "object",
  "properties": {
    "ruc": {
      "type": "string",
      "description": "Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
    },
    "razon_social": {
      "type": "string",
      "description": "Registered legal name.",
      "x-latinfo-meaning": "text"
    },
    "estado": {
      "type": "string",
      "description": "Publisher status; interpret in the context of this dataset.",
      "x-latinfo-meaning": "text",
      "enum": [
        "ACTIVO",
        "PASIVO",
        "SUSPENDIDO"
      ],
      "x-latinfo-vocabulary": {
        "id": "ec.sri.tax_status.v1",
        "scope": "TAX_REGISTRATION",
        "empty_policy": "reject",
        "values": {
          "ACTIVO": {
            "code": "ACTIVE",
            "label_en": "Active",
            "explanation_en": "SRI reports the taxpayer registration as active."
          },
          "PASIVO": {
            "code": "INACTIVE",
            "label_en": "Inactive",
            "explanation_en": "SRI reports the taxpayer registration as passive, meaning it is not currently active."
          },
          "SUSPENDIDO": {
            "code": "SUSPENDED",
            "label_en": "Suspended",
            "explanation_en": "SRI reports the taxpayer registration as suspended."
          }
        }
      }
    },
    "nombre_fantasia": {
      "type": "string",
      "description": "Published trade name; may be absent.",
      "x-latinfo-meaning": "text"
    },
    "actividad_economica": {
      "type": "string",
      "description": "Published economic-activity description.",
      "x-latinfo-meaning": "text"
    },
    "codigo_ciiu": {
      "type": "string",
      "description": "Published CIIU economic-activity code.",
      "x-latinfo-meaning": "code"
    },
    "fecha_inicio_actividades": {
      "type": "string",
      "description": "Published fecha inicio actividades date. Format: YYYY-MM-DD HH:mm:ss.",
      "x-latinfo-meaning": "date"
    },
    "fecha_suspension": {
      "type": "string",
      "description": "Published fecha suspension date. Format: YYYY-MM-DD HH:mm:ss.",
      "x-latinfo-meaning": "date"
    },
    "fecha_actualizacion": {
      "type": "string",
      "description": "Published fecha actualizacion date. Format: YYYY-MM-DD HH:mm:ss.",
      "x-latinfo-meaning": "date"
    },
    "obligado_contabilidad": {
      "type": "string",
      "description": "S/N: whether accounting books are required.",
      "x-latinfo-meaning": "text"
    },
    "agente_retencion": {
      "type": "string",
      "description": "S/N: published withholding-agent designation.",
      "x-latinfo-meaning": "text"
    },
    "contribuyente_especial": {
      "type": "string",
      "description": "S/N: published special-taxpayer designation.",
      "x-latinfo-meaning": "text"
    },
    "provincia": {
      "type": "string",
      "description": "Published province name.",
      "x-latinfo-meaning": "text"
    },
    "canton": {
      "type": "string",
      "description": "Province subdivision of the principal establishment.",
      "x-latinfo-meaning": "text"
    },
    "parroquia": {
      "type": "string",
      "description": "Parish of the principal establishment.",
      "x-latinfo-meaning": "text"
    }
  },
  "required": [
    "ruc",
    "razon_social",
    "estado",
    "nombre_fantasia",
    "actividad_economica",
    "codigo_ciiu",
    "fecha_inicio_actividades",
    "fecha_suspension",
    "fecha_actualizacion",
    "obligado_contabilidad",
    "agente_retencion",
    "contribuyente_especial",
    "provincia",
    "canton",
    "parroquia"
  ],
  "additionalProperties": false
}

400Invalid identifier or query. Correct the input before retrying.