Consultar situacion tributaria de tercero

GET/api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}v1 · ESTABLE

GET /api/v1/sii/contribuyentes/situacion_tributaria/tercero/{rut}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.get(
    "https://api.fiscalbridge.cl/api/v1/sii/contribuyentes/situacion_tributaria/tercero/76.XXX.XXX-K",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Consultar situacion tributaria de un contribuyente tercero.

Consulta la situacion tributaria actual (razon social, fecha de inicio de actividades, actividades economicas, documentos timbrados, estado PRO-PYME y obligacion DTE) de un contribuyente por RUT, a traves del servicio SIAC del SII.

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 del contribuyente. Formato: `XX.XXX.XXX-X`

Respuesta exitosa (200)

{
    "success": true,
    "message": "Situacion tributaria encontrada exitosamente",
    "data": {
        "rut": 76000000,
        "dv": "K",
        "razon_social": "Empresa Ejemplo SpA",
        "inicio_actividades": true,
        "fecha_inicio_actividades": "2020-01-15",
        "moneda_extranjera": false,
        "pro_pyme": true,
        "obligacion_dte": true,
        "excepcion_dte": false,
        "actividades": [
            {
                "codigo": "619090",
                "glosa": "OTRAS ACTIVIDADES DE TELECOMUNICACIONES",
                "afecta": true,
                "categoria": 1
            }
        ],
        "documentos_timbrados": [
            {"documento": "Factura Electronica", "ultimo_timbraje": 2024}
        ],
        "observaciones": {
            "inconcurrente": false,
            "suplantado": false,
            "no_ubicado": false,
            "termino_giro": false,
            "domicilio_inexistente": false,
            "actividad_esporadica": false,
            "no_habido_domicilio": false,
            "termino_giro_obligatorio": false
        }
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`INVALID_RUT_FORMAT`	RUT no cumple formato XX.XXX.XXX-X	Verificar formato
400	`INVALID_RUT_CHECKSUM`	Digito verificador incorrecto	Recalcular con algoritmo modulo 11
400	`VALIDATION_ERROR`	Error de validacion del servicio	Revisar `message` para detalle
401	`HTTP_401`	API token ausente o invalido	Enviar header `X-API-Token: <token>` valido
403	`HTTP_403`	Sin scope `sii:read` o cuenta bloqueada	Generar token con scope adecuado
429	`SII_RATE_LIMIT`	SII respondio con rate limit	Reintentar tras `Retry-After`
429	Quota/Throttle excedido	Cuota diaria o req/s agotado	Esperar reset o upgrade plan
502	`SII_GATEWAY_ERROR`	SII respondio con error estructurado	Revisar `message` y `details.observacion`
503	`SII_UNAVAILABLE`	SII en mantenimiento (HTTP 503 upstream)	Reintentar en 5 minutos
504	`SII_TIMEOUT`	Conexion al SII excedio timeout	Reintentar

Rate Limiting

Consume 1 consulta de la cuota diaria. Headers de respuesta:

X-RateLimit-Limit: Cuota total del plan
X-RateLimit-Remaining: Consultas restantes
X-RateLimit-Reset: Timestamp UTC del proximo reset

Notas

Los datos se obtienen en tiempo real del portal SIAC del SII.
En periodo de Operacion Renta (abril-mayo) el SII puede presentar lentitud.
Los RUTs en ejemplos son ficticios (76.XXX.XXX-K); el RUT del body sera el real.

Parámetros

Header / Body

Tipo

Descripción

Requerido

rut

string · path

RUT del contribuyente consultado. Formato: `XX.XXX.XXX-X` o `XXXXXXXX-X`

Sí

Respuestas

200Successful Response

400RUT invalido (formato o digito verificador)

401API token ausente o invalido (header X-API-Token requerido)

403Sin permisos o cuenta bloqueada

422Validation Error

429Limite de tasa excedido (quota o throttle)

502Error en servicio SII upstream

503SII en mantenimiento

504Timeout consultando al SII

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

Consultar situacion tributaria de tercero

On this page