---
title: "Validación de RUC contra el catastro del SRI"
method: GET
path: "/sri/ruc/{ruc}"
tags: ["catalogos"]
---

# Validación de RUC contra el catastro del SRI

`GET /sri/ruc/{ruc}`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/sri/ruc/{ruc}`
- Auth: HTTP bearer

Veredicto SIEMPRE 200: `valido` (estructura y dígito verificador; el RUC de sociedad privada se valida solo por estructura, como hace el SRI), `encontrado` (consta en el catastro) y, si consta, el contribuyente con razón social, estado, régimen mapeado (`GENERAL | RIMPE_EMPRENDEDOR | RIMPE_NEGOCIO_POPULAR`) y crudo (`regimenSri`), tipo de contribuyente, actividad económica (descripción, no CIIU), dirección, `obligadoContabilidad`, `contribuyenteEspecial` y `agenteRetencion`, más `advertencias` (RUC suspendido, fantasma o con transacciones inexistentes). Resiliente: caché de 24 h y, si el SRI no responde, sirve la última copia (hasta 7 días, `fuente: "cache"` y `degradado: true` si venció su frescura); sin copia responde `degradado: true` con `motivo`. Nunca 404 ni 503. Alcanzable con API key (roles emisor, contador o lector).

## Path parameters

- `ruc` string, required

## Response `200`

Veredicto de validación

- object
  - `ruc` string, required
  - `valido` boolean, required
  - `encontrado` boolean, required
  - `motivo` string
  - `degradado` boolean
  - `fuente` 'sri' | 'cache'
  - `consultadoAt` string, date-time, required
  - `contribuyente` object
    - `razonSocial` string, required
    - `estado` string
    - `regimen` 'GENERAL' | 'RIMPE_EMPRENDEDOR' | 'RIMPE_NEGOCIO_POPULAR', required
    - `regimenSri` string
    - `tipoContribuyente` string
    - `actividadEconomica` string
    - `direccion` string
    - `obligadoContabilidad` boolean
    - `contribuyenteEspecial` boolean
    - `agenteRetencion` boolean
  - `advertencias` string[], required

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)