Consultar datos privados del contribuyente DTE

POST/api/v1/sii/dte/contribuyentes/datos/{contribuyente}v1 · ESTABLE

POST /api/v1/sii/dte/contribuyentes/datos/{contribuyente}

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

Consultar datos privados de un contribuyente DTE.

Retorna los datos privados registrados en el SII para el contribuyente: direccion, telefono, email de contacto, giros, etc. Solo accesible con certificado digital del contribuyente o de representante autorizado.

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

certificado digital en el body (con permiso sobre el RUT consultado).

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`contribuyente`	string	Si	RUT del contribuyente (`XXXXXXXX-K`)

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion
`formato`	string	`json`	`json` (default) o `html`

Respuesta exitosa (200)

{
    "success": true,
    "message": "Datos privados de contribuyente obtenidos exitosamente",
    "data": {
        "rut": "76.XXX.XXX-K",
        "razon_social": "EMPRESA EJEMPLO SPA",
        "direccion": "Av. Ejemplo 123, Santiago",
        "telefono": "+56 2 2345 6789",
        "email": "contacto@empresa.cl",
        "giros": [
            "Servicios profesionales"
        ]
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`AUTH_ERROR`	Certificado sin permiso sobre el RUT	Usar certificado del contribuyente o representante
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 (`XXXXXXXX-K`)

Sí

ambiente

string · query

`0` produccion, `1` certificacion

formato

string · query

`json` (default) o `html`

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400RUT invalido o credenciales SII incorrectas

401API token ausente o invalido

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

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

Consultar datos privados del contribuyente DTE

On this page