English
EspañolEnglishPortuguêsFilipino
Get free API key
Ecuador · ec_sri_padron_ruc
OpenAPI

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.

Source contract

Publisher
Servicio de Rentas Internas, Ecuador
Coverage
Corporate RUCs in the published SRI province files.
Record meaning
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.
Accepted pattern
^\d{13}$
Cardinality
one
License
Reuse permission has not been verified. Public access is not a reuse license.

Known limitations

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

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

rucstringpathrequired

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

Example: 1793025048001

Request example

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

Responses

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

Response headers

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

Response fields

ruc string required

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

razon_social string required

Registered legal name.

estado string required

Publisher status; interpret in the context of this dataset.

ACTIVO · PASIVO · SUSPENDIDO

Value meanings

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 required

Published trade name; may be absent.

actividad_economica string required

Published economic-activity description.

codigo_ciiu string required

Published CIIU economic-activity code.

fecha_inicio_actividades string required

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

fecha_suspension string required

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

fecha_actualizacion string required

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

obligado_contabilidad string required

S/N: whether accounting books are required.

agente_retencion string required

S/N: published withholding-agent designation.

contribuyente_especial string required

S/N: published special-taxpayer designation.

provincia string required

Published province name.

canton string required

Province subdivision of the principal establishment.

parroquia string required

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

Illustrative schema example. This is not a live response.

{
  "ruc": "string",
  "razon_social": "string",
  "estado": "ACTIVO",
  "nombre_fantasia": "string",
  "actividad_economica": "string",
  "codigo_ciiu": "string",
  "fecha_inicio_actividades": "string",
  "fecha_suspension": "string",
  "fecha_actualizacion": "string",
  "obligado_contabilidad": "string",
  "agente_retencion": "string",
  "contribuyente_especial": "string",
  "provincia": "string",
  "canton": "string",
  "parroquia": "string"
}

Provenance and limitations

Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.

Esc