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.

Kontrata ng source

Publisher: Servicio de Rentas Internas, Ecuador
Saklaw: Corporate RUCs in the published SRI province files.
Kahulugan ng tala: A taxpayer registration with principal-establishment geography and activity.
Identifier: Lookup by ruc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern: ^\d{13}$
Bilang ng mga tala: one
Lisensya: Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

rucstringpathkailangan

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

Example: 1793025048001

Halimbawa ng request

curl https://api.latinfo.dev/ec/sri/padron/ruc/1793025048001 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

ruc string kailangan

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

razon_social string kailangan

Registered legal name.

estado string kailangan

Publisher status; interpret in the context of this dataset.

ACTIVO · PASIVO · SUSPENDIDO

Kahulugan ng mga value

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 kailangan

Published trade name; may be absent.

actividad_economica string kailangan

Published economic-activity description.

codigo_ciiu string kailangan

Published CIIU economic-activity code.

fecha_inicio_actividades string kailangan

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

fecha_suspension string kailangan

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

fecha_actualizacion string kailangan

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

obligado_contabilidad string kailangan

S/N: whether accounting books are required.

agente_retencion string kailangan

S/N: published withholding-agent designation.

contribuyente_especial string kailangan

S/N: published special-taxpayer designation.

provincia string kailangan

Published province name.

canton string kailangan

Province subdivision of the principal establishment.

parroquia string kailangan

Parish of the principal establishment.

Response schema

{
  "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.