Obtener informacion publica de un contribuyente MIPYME

POST/api/v1/sii/mipyme/contribuyentes/info/{contribuyente}/{emisor}/{dte}v1 · ESTABLE

POST /api/v1/sii/mipyme/contribuyentes/info/{contribuyente}/{emisor}/{dte}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/mipyme/contribuyentes/info/11111111-1/76192083-9/33",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Consultar informacion publica de un contribuyente en MIPYME.

Consulta informacion publica de un contribuyente en el portal MIPYME. El RUT + clave tributaria del body identifica a la persona natural con acceso al portal (puede ser representante de varias empresas); el path param emisor identifica la empresa que esa persona va a representar para la operacion.

Autenticacion requerida: API token en header X-API-Token con scope sii:read

credenciales SII PassAuth (persona representante) en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`contribuyente`	string	Si	RUT del contribuyente a consultar
`emisor`	string	Si	RUT de la empresa a representar
`dte`	integer	Si	Tipo DTE

Body (JSON)

{
    "auth": {
        "pass": {"rut": "12.345.678-9", "clave": "clave_tributaria_persona"}
    }
}

El auth.pass.rut es la persona natural con acceso al portal; el emisor del path determina la empresa.

Respuesta exitosa (200)

{
    "rut": "11.111.111-1",
    "razon_social": "CONTRIBUYENTE EJEMPLO",
    "autorizado_dte": true,
    "direccion": "Calle Ejemplo 123"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	RUT invalido	Usar `XXXXXXXX-K`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`AUTH_ERROR`	Persona sin representacion sobre empresa	Usar representante autorizado
404	`HTTP_404`	Contribuyente no existe en MIPYME	Verificar RUT
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Parámetros

Header / Body

Tipo

Descripción

Requerido

contribuyente

string · path

RUT del contribuyente consultado

Sí

dte

integer · path

Tipo de DTE (33, 34, 39, etc.)

Sí

emisor

string · path

RUT de la empresa a representar en MIPYME (puede diferir del `auth.pass.rut`)

Sí

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

Respuestas

200Successful Response

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o sin permiso sobre empresa

404Contribuyente no encontrado

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

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"
}

Obtener informacion publica de un contribuyente MIPYME

On this page