Verificar RUT con serie de cedula
Verificar validez de RUT con serie de cedula de identidad.
GET
/api/v1/sii/contribuyentes/rut/verificar/{rut}/{serie}v1 · ESTABLEGET /api/v1/sii/contribuyentes/rut/verificar/{rut}/{serie}
Verificar validez de RUT con serie de cedula de identidad.
Verifica la validez de un RUT combinando el RUT con el numero de serie de la cedula de identidad del titular, consultando el servicio de verificacion del SII. Retorna datos del titular cuando la cedula esta vigente, o un mensaje cuando esta anulada.
Autenticacion requerida: API token en header X-API-Token con scope sii:read.
Quota: Consume 1 consulta | Peso: 1x
Parametros de ruta
| Parametro | Tipo | Requerido | Descripcion |
|---|---|---|---|
rut | string | Si | RUT a verificar. Formato: XX.XXX.XXX-X |
serie | string | Si | Numero de serie de cedula (solo digitos) |
Respuesta exitosa - cedula vigente (200)
Respuesta exitosa - cedula anulada (200)
Cuando la cedula esta anulada, el payload puede contener solo
anulada + mensaje, omitiendo los demas campos.
Errores especificos
| Codigo | error_code | Causa | Resolucion |
|---|---|---|---|
| 400 | INVALID_RUT_FORMAT | RUT no cumple formato | Usar XX.XXX.XXX-X |
| 400 | INVALID_RUT_CHECKSUM | Digito verificador incorrecto | Recalcular con modulo 11 |
| 400 | EMPTY_SERIE | Numero de serie vacio | Enviar serie con digitos |
| 400 | INVALID_SERIE_FORMAT | Serie contiene no-digitos | Usar solo digitos |
| 400 | VALIDATION_ERROR | Error de validacion del servicio | Revisar message |
| 422 | SERIE_INVALIDA | SII rechazo la serie | Verificar serie contra cedula |
| 429 | SII_RATE_LIMIT | SII respondio con rate limit | Esperar Retry-After |
| 501 | SERVICE_NOT_READY | Servicio no disponible temporalmente | Contactar soporte |
| 502 | SII_GATEWAY_ERROR | Error al consultar el SII | Reintentar |
| 502 | SII_GATEWAY_ERROR | SII respondio con error | Revisar message |
| 503 | CAPTCHA_SOLVER_NOT_CONFIGURED | Servicio no disponible temporalmente | Contactar soporte |
| 503 | SERVICIO_NO_DISPONIBLE | Portal SII no disponible | Reintentar en 5 minutos |
| 503 | SII_UNAVAILABLE | SII en mantenimiento | Reintentar en 5 minutos |
Notas
- El SII puede rechazar series que no coincidan con el RUT.
- La serie varia segun el tipo de cedula (chilena / extranjera).
Parámetros
Header / Body
Tipo
Descripción
Requerido
rut
string · path
RUT a verificar. Formato: `XX.XXX.XXX-X` o `XXXXXXXX-X`
Sí
serie
string · path
Numero de serie de la cedula de identidad (solo digitos)
Sí
Respuestas
200Successful Response
400RUT o serie invalidos
401API token ausente o invalido
403Sin permisos o cuenta bloqueada
422Serie invalida rechazada por SII
429Limite de tasa excedido
501Servicio no disponible temporalmente
502Error al consultar el SII
503SII no disponible o servicio en mantenimiento
Forma de la respuesta
Código 200. Estructura del JSON devuelto.