{"openapi":"3.1.0","info":{"title":"Datario API","version":"0.1.0"},"paths":{"/v1/rut/{rut_crudo}":{"get":{"summary":"Ficha","operationId":"ficha_v1_rut__rut_crudo__get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta una consulta.","content":{"application/json":{"schema":{"title":"Response Ficha V1 Rut  Rut Crudo  Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"fuente":"Nóminas públicas de contribuyentes, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00","razon_social":"CORP NACIONAL DEL COBRE DE CHILE","actividades":[{"codigo":40000,"descripcion":"EXTRACCION Y PROCESAMIENTO DE COBRE","afecta_iva":true,"desde":"1993-01-01"},{"codigo":351020,"descripcion":"TRANSMISION DE ENERGIA ELECTRICA","afecta_iva":true,"desde":"2012-11-16"}],"domicilios":[{"tipo":"matriz","direccion":"HUERFANOS 1270","calle":"HUERFANOS 1270","numero":"","departamento":"","comuna":"SANTIAGO","ciudad":"","region":"XIII REGION METROPOLITANA","bloque":"","villa":"","vigente_desde":"2007-03-27"},{"tipo":"sucursal","direccion":"AV. LA MONTANA 1550","calle":"AV. LA MONTANA","numero":"1550","departamento":"","comuna":"LAMPA","ciudad":"SANTIAGO","region":"XIII REGION METROPOLITANA","bloque":"","villa":"VALLE GRANDE","vigente_desde":"2012-03-20"}],"casilla_intercambio":"","tipo_sociedad":"INSTITUCIONES FISCALES","subtipo_sociedad":"ORG. ADMINISTRACION PUBLICA","cod_subtipo":"517","inicio_actividades":"1993-01-01","tamano":{"anio_comercial":2024,"tramo_ventas":{"codigo":13,"descripcion":"4to Rango Gran Empresa","desde_uf":1000000.01,"categoria":"Gran empresa"},"trabajadores":16946,"regimen":{"codigo":"no14","descripcion":"CONTRIBUYENTES NO SUJETOS AL ARTICULO 14"},"renta_presunta":false,"rubro":{"codigo":"B","descripcion":"EXPLOTACION DE MINAS Y CANTERAS"},"subrubro":"EXTRACCION Y PROCESAMIENTO DE COBRE","actividad_principal":40000,"primera_inscripcion":"1993-01-01","comuna":"SANTIAGO"},"gran_contribuyente":true,"grupo_economico":39,"concursal":{"fuente":"Boletín Concursal, Superintendencia de Insolvencia y Reemprendimiento","actualizado_al":"2026-09-09","procedimientos":[]},"emisor_electronico":{"desde":"2007-10-30","sistema":"mercado"},"origenes":[{"publicacion":"Nómina de personas jurídicas","organismo":"Servicio de Impuestos Internos","enlace":"https://www.sii.cl/estadisticas/nominas/PUB_NOMBRES_PJ.zip","publicado":"2026-08-05T15:32:50+00:00","campos":["razon_social","tipo_sociedad","subtipo_sociedad","cod_subtipo","inicio_actividades","termino_giro"]},{"publicacion":"Nómina de actividades económicas","organismo":"Servicio de Impuestos Internos","enlace":"https://www.sii.cl/estadisticas/nominas/PUB_NOM_ACTECOS.zip","publicado":"2026-08-05T15:34:49+00:00","campos":["actividades"]},{"publicacion":"Nómina de direcciones","organismo":"Servicio de Impuestos Internos","enlace":"https://www.sii.cl/estadisticas/nominas/PUB_NOM_DIRECCIONES.zip","publicado":"2026-08-05T15:36:37+00:00","campos":["domicilios"]},{"publicacion":"Nómina anual de empresas","organismo":"Servicio de Impuestos Internos","enlace":"https://www.sii.cl/estadisticas/nominas/PUB_EMPRESAS_PJ_2020_A_2024.zip","publicado":"2026-01-29T15:31:29+00:00","campos":["tamano"]},{"publicacion":"Nómina de Grandes Contribuyentes","organismo":"Servicio de Impuestos Internos","enlace":"https://www.sii.cl/normativa_legislacion/resoluciones/2025/reso208_anexo1.pdf","publicado":"2025-12-31T15:38:32+00:00","campos":["gran_contribuyente","grupo_economico"]},{"publicacion":"Lista de emisores electrónicos","organismo":"Servicio de Impuestos Internos","enlace":"https://palena.sii.cl/cvc/dte/ee_empresas_dte.html","publicado":"2026-10-01T06:00:00+00:00","campos":["emisor_electronico"]},{"publicacion":"Registro de Empresas y Sociedades","organismo":"Subsecretaría de Economía y Empresas de Menor Tamaño","enlace":"https://datos.gob.cl/dataset/registro-de-empresas-y-sociedades","publicado":"2026-09-28T17:31:52+00:00","campos":["constitucion"]},{"publicacion":"Boletín Concursal","organismo":"Superintendencia de Insolvencia y Reemprendimiento","enlace":"https://www.boletinconcursal.cl/boletin/procedimientos","actualizado_al":"2026-09-09","campos":["concursal"]}]}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta una consulta.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/actividades":{"get":{"summary":"Actividades","operationId":"actividades_v1_rut__rut_crudo__actividades_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Actividades V1 Rut  Rut Crudo  Actividades Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"fuente":"Nóminas públicas de contribuyentes, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00","actividades":[{"codigo":40000,"descripcion":"EXTRACCION Y PROCESAMIENTO DE COBRE","afecta_iva":true,"desde":"1993-01-01"},{"codigo":351020,"descripcion":"TRANSMISION DE ENERGIA ELECTRICA","afecta_iva":true,"desde":"2012-11-16"}]}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta una consulta.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/sociedades":{"get":{"summary":"Sociedades","operationId":"sociedades_v1_rut__rut_crudo__sociedades_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta 10 consultas, también con las listas vacías: «no participa en nada» es información. Descuenta 10 consultas.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sociedades V1 Rut  Rut Crudo  Sociedades Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"participaciones":[{"rut":"76028880-2","rut_formateado":"76.028.880-2","razon_social":"SOCIEDAD CONTRACTUAL MINERA PUREN","participacion":35.0},{"rut":"76148338-2","rut_formateado":"76.148.338-2","razon_social":"SOCIEDAD DE PROCESAMIENTO DE MOLIBDENO SPA","participacion":100.0}],"socios":[],"fuente":"Composición de sociedades, SII","publicado":"2025-11-25T16:11:42+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta 10 consultas.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/grupos":{"get":{"summary":"Grupo","operationId":"grupo_v1_rut__rut_crudo__grupos_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}},{"name":"saltos","in":"query","required":false,"schema":{"type":"string","default":"","title":"Saltos"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta 10 consultas por el nivel 1 y, del saldo, la tarifa de cada nivel siguiente que trajo empresas: este, pedido con `saltos=2`, trajo el nivel 2 ($1.990). Con la red entera o truncada, se cobra lo que se entrega. Descuenta 10 consultas.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Grupo V1 Rut  Rut Crudo  Grupos Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"saltos":2,"empresas":[{"rut":"76063022-5","rut_formateado":"76.063.022-5","razon_social":"INCA DE ORO S.A.","distancia":1},{"rut":"76092641-8","rut_formateado":"76.092.641-8","razon_social":"PANAUST MINERA IDO LIMITADA","distancia":2}],"participaciones":[{"socio":"61704000-K","sociedad":"76063022-5","participacion":30.6},{"socio":"76092641-8","sociedad":"76063022-5","participacion":69.4}],"truncado":false,"fuente":"Composición de sociedades, SII","publicado":"2025-11-25T16:11:42+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}},"X-Charged-CLP":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta. · Pediste más saltos de los que el grupo sigue. No se cobra: no hubo lectura. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta. · El grafo tardó más que su techo propio: pasa con holdings de miles de filiales y 3 saltos. No se cobra, y con menos saltos casi siempre responde. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta 10 consultas.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/tamanos":{"get":{"summary":"Tamanos","operationId":"tamanos_v1_rut__rut_crudo__tamanos_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta una consulta, también con la lista vacía: «el SII nunca lo clasificó» es información. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Tamanos V1 Rut  Rut Crudo  Tamanos Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"anios":[{"anio_comercial":2024,"tramo_ventas":{"codigo":13,"descripcion":"4to Rango Gran Empresa","desde_uf":1000000.01,"categoria":"Gran empresa"},"trabajadores":16946,"regimen":{"codigo":"no14","descripcion":"CONTRIBUYENTES NO SUJETOS AL ARTICULO 14"},"renta_presunta":false,"rubro":{"codigo":"B","descripcion":"EXPLOTACION DE MINAS Y CANTERAS"},"subrubro":"EXTRACCION Y PROCESAMIENTO DE COBRE"}],"fuente":"Nómina anual de empresas, SII","publicado":"2026-01-29T15:31:29+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta una consulta.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/historial":{"get":{"summary":"Historial","operationId":"historial_v1_rut__rut_crudo__historial_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón o tuvo cambios. Descuenta una consulta, también con la lista vacía: «no cambió» es información. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Historial V1 Rut  Rut Crudo  Historial Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"cambios":[],"fuente":"Padrón del SII, comparado publicación a publicación por Datario, y Boletín Concursal","publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"RUT con dígito verificador correcto que no está en el padrón y no tiene cambios guardados: nunca los tuvo o ya cumplieron su plazo. Descuenta una consulta: buscarlo fue el trabajo. Descuenta una consulta.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/rut/{rut_crudo}/domicilios":{"get":{"summary":"Domicilios","operationId":"domicilios_v1_rut__rut_crudo__domicilios_get","parameters":[{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT está en el padrón. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Domicilios V1 Rut  Rut Crudo  Domicilios Get"},"example":{"rut":"61704000-K","rut_formateado":"61.704.000-K","es_empresa":true,"fuente":"Nóminas públicas de contribuyentes, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00","domicilios":[{"tipo":"matriz","direccion":"HUERFANOS 1270","calle":"HUERFANOS 1270","numero":"","departamento":"","comuna":"SANTIAGO","ciudad":"","region":"XIII REGION METROPOLITANA","bloque":"","villa":"","vigente_desde":"2007-03-27"},{"tipo":"sucursal","direccion":"AV. LA MONTANA 1550","calle":"AV. LA MONTANA","numero":"1550","departamento":"","comuna":"LAMPA","ciudad":"SANTIAGO","region":"XIII REGION METROPOLITANA","bloque":"","villa":"VALLE GRANDE","vigente_desde":"2012-03-20"}]}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta. · No tiene forma de RUT: cuerpo fuera de 7-8 dígitos, o los ocho caracteres sin guion, que son ambiguos. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"404":{"description":"El RUT es válido pero el SII no lo tiene. SÍ descuenta lo que cuesta la operación pedida: «no está» también es información. Descuenta una consulta.","content":{"application/json":{"example":{"error":"rut_no_registrado","detail":"El SII no registra datos para 12345678-5."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}}}}},"/v1/empresas":{"get":{"summary":"Empresas","operationId":"empresas_v1_empresas_get","parameters":[{"name":"razon_social","in":"query","required":false,"schema":{"type":"string","default":"","title":"Razon Social"}},{"name":"actividad","in":"query","required":false,"schema":{"type":"string","default":"","title":"Actividad"}},{"name":"comuna","in":"query","required":false,"schema":{"type":"string","default":"","title":"Comuna"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"modo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Modo"}},{"name":"limite","in":"query","required":false,"schema":{"type":"string","default":"","title":"Limite"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"string","default":"","title":"Pagina"}},{"name":"vigentes","in":"query","required":false,"schema":{"type":"string","default":"","title":"Vigentes"}}],"responses":{"200":{"description":"Hay página que devolver — también cuando viene vacía: «no hay coincidencias» es información. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Empresas V1 Empresas Get"},"example":{"resultados":[{"rut":"61704000-K","rut_formateado":"61.704.000-K","razon_social":"CORP NACIONAL DEL COBRE DE CHILE","comuna":"SANTIAGO","region":"XIII REGION METROPOLITANA"}],"destacadas":[],"hay_mas":true,"pagina_siguiente":"eyJsciI6IjYxNzA0In0.q1w2e3","fuente":"Nóminas públicas de contribuyentes, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"Pediste la búsqueda sin ningún filtro. La API no lista el padrón entero. No descuenta. · El texto es tan corto que calzaría con medio padrón. No se cobra: no hubo búsqueda. No descuenta. · Con `modo=contiene`, el texto no trae ninguna letra ni ningún número («%%%», «---»): calzaría con cualquier cosa. Con `modo=empieza` sí se acepta. No se cobra: no hubo búsqueda. No descuenta. · El texto pasa de cien caracteres, y ninguna razón social del padrón se acerca a esa cifra. No se cobra: no hubo búsqueda. No descuenta. · Un filtro de texto trae el carácter nulo (`%00`). No se cobra: no hubo lectura. No descuenta. · Un parámetro llegó dos veces (`?comuna=A&comuna=B`): no se elige uno por ti. El detail nombra el que se repitió. No se cobra. No descuenta. · El giro se filtra por su código (el mismo `codigo` de las actividades): un entero positivo de 32 bits, no un texto. No descuenta. · `modo` llegó con un valor que no es ninguno de los dos. No descuenta. · `vigentes` llegó con un valor que no es `true` ni `false`. No se cobra: no hubo búsqueda. No descuenta. · `limite` quedó fuera del rango publicado. No se cobra: no hubo búsqueda. No descuenta. · El token de página llegó adulterado o incompleto. Se pide de nuevo desde la primera. No descuenta. · Con `pagina`, los filtros van DENTRO del token. Idénticos se aceptan; distintos no. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"Indica al menos un filtro: razon_social, actividad, comuna o region."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La búsqueda superó su techo de tiempo. No descuenta. Pasa con un texto muy común: acótalo o agrega un filtro de giro, comuna o región. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}}}}},"/v1/cambios":{"get":{"summary":"Cambios","operationId":"cambios_v1_cambios_get","parameters":[{"name":"desde","in":"query","required":false,"schema":{"type":"string","default":"","title":"Desde"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string","default":"","title":"Hasta"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tipo"}},{"name":"aspecto","in":"query","required":false,"schema":{"type":"string","default":"","title":"Aspecto"}},{"name":"campo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Campo"}},{"name":"comuna","in":"query","required":false,"schema":{"type":"string","default":"","title":"Comuna"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"actividad","in":"query","required":false,"schema":{"type":"string","default":"","title":"Actividad"}},{"name":"limite","in":"query","required":false,"schema":{"type":"string","default":"","title":"Limite"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"string","default":"","title":"Pagina"}}],"responses":{"200":{"description":"Hay página que devolver — también la vacía, que descuenta una. Con cambios, descuenta uno por cada uno. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cambios V1 Cambios Get"},"example":{"cambios":[],"hay_mas":false,"fuente":"Padrón del SII, comparado publicación a publicación por Datario, y Boletín Concursal","publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"Faltó `desde`. Cada cambio devuelto descuenta una consulta, y sin un día de partida una página podría traer meses. No se cobra. No descuenta. · `hasta` no es un día ISO. No se cobra. No descuenta. · Los dos días están al revés. No se cobra. No descuenta. · `tipo` no es una de las tres palabras de la tabla. No se cobra. No descuenta. · `aspecto` no es una de las partes de la ficha que el historial registra. No se cobra. No descuenta. · `campo` no es un campo de `contribuyente`. No se cobra. No descuenta. · `campo` vino con otro aspecto: solo `contribuyente` tiene campos que comparar. No se cobra. No descuenta. · El giro se filtra por su código (el mismo `codigo` de las actividades): un entero positivo de 32 bits, no un texto. No descuenta. · Un filtro de texto trae el carácter nulo (`%00`). No se cobra: no hubo lectura. No descuenta. · Un parámetro llegó dos veces (`?comuna=A&comuna=B`): no se elige uno por ti. El detail nombra el que se repitió. No se cobra. No descuenta. · `limite` quedó fuera del rango publicado. No se cobra: no hubo lectura. No descuenta. · El token de página llegó adulterado o incompleto. Se pide de nuevo desde la primera. No descuenta. · Con `pagina`, los filtros van DENTRO del token. Idénticos se aceptan; distintos no. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"Indica desde: el día desde el que quieres los cambios (YYYY-MM-DD)."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La enumeración tardó más que su techo de tiempo: pasa con muchos días y un filtro por comuna o giro sobre una publicación grande. No se cobra. Acota `desde` y `hasta`, o pide menos por página. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}}}}},"/v1/prospeccion":{"get":{"summary":"Prospeccion","operationId":"prospeccion_v1_prospeccion_get","parameters":[{"name":"categoria","in":"query","required":false,"schema":{"type":"string","default":"","title":"Categoria"}},{"name":"tramo_minimo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tramo Minimo"}},{"name":"tramo_maximo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tramo Maximo"}},{"name":"trabajadores_minimo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Trabajadores Minimo"}},{"name":"trabajadores_maximo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Trabajadores Maximo"}},{"name":"rubro","in":"query","required":false,"schema":{"type":"string","default":"","title":"Rubro"}},{"name":"regimen","in":"query","required":false,"schema":{"type":"string","default":"","title":"Regimen"}},{"name":"actividad","in":"query","required":false,"schema":{"type":"string","default":"","title":"Actividad"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string","default":"","title":"Provincia"}},{"name":"comuna","in":"query","required":false,"schema":{"type":"string","default":"","title":"Comuna"}},{"name":"vigentes","in":"query","required":false,"schema":{"type":"string","default":"","title":"Vigentes"}},{"name":"crecio","in":"query","required":false,"schema":{"type":"string","default":"","title":"Crecio"}},{"name":"limite","in":"query","required":false,"schema":{"type":"string","default":"","title":"Limite"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"string","default":"","title":"Pagina"}}],"responses":{"200":{"description":"Hay página que devolver — también la vacía, que descuenta una. Con empresas, descuenta una por cada una que no hayas recibido en este ciclo. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prospeccion V1 Prospeccion Get"},"example":{"filtros":{"categoria":["grande"],"trabajadores_minimo":10000,"rubro":["B"],"regimen":[],"comuna":"13101","vigentes":true,"crecio":false},"empresas":[{"rut":"61704000-K","rut_formateado":"61.704.000-K","razon_social":"CORP NACIONAL DEL COBRE DE CHILE","vigente":true,"anio_comercial":2024,"tramo_ventas":{"codigo":13,"descripcion":"4to Rango Gran Empresa","desde_uf":1000000.01,"categoria":"Gran empresa"},"trabajadores":16946,"rubro":{"codigo":"B","descripcion":"EXPLOTACION DE MINAS Y CANTERAS"},"subrubro":"EXTRACCION Y PROCESAMIENTO DE COBRE","regimen":{"codigo":"no14","descripcion":"CONTRIBUYENTES NO SUJETOS AL ARTICULO 14"},"casa_matriz":{"comuna":{"codigo":"13101","nombre":"Santiago"},"provincia":{"codigo":"131","nombre":"Santiago"},"region":{"codigo":"13","nombre":"Región Metropolitana de Santiago"}}}],"nuevas":1,"hay_mas":false,"fuente":"Nóminas públicas de contribuyentes y nómina anual de empresas, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"`categoria` no es un tamaño. No descuenta. · Un tramo fuera de la leyenda del SII. No descuenta. · Un mínimo o máximo de trabajadores negativo, o que no cabe en 32 bits. No descuenta. · Un mínimo mayor que su máximo. No descuenta. · `rubro` no es una sección CIIU. No descuenta. · `regimen` no es uno de los publicados. No descuenta. · `region` no es una región de Chile. No descuenta. · `provincia` no es una provincia de Chile. No descuenta. · `comuna` no es una comuna de Chile. No descuenta. · `vigentes` no es `true` ni `false`. No descuenta. · `crecio` no es `true` ni `false`. No descuenta. · El giro se filtra por su código (el mismo `codigo` de las actividades): un entero positivo de 32 bits, no un texto. No descuenta. · Un parámetro llegó dos veces (`?comuna=A&comuna=B`): no se elige uno por ti. El detail nombra el que se repitió. No se cobra. No descuenta. · `limite` quedó fuera del rango publicado. No se cobra: no hubo lectura. No descuenta. · El token de página llegó adulterado o incompleto. Se pide de nuevo desde la primera. No descuenta. · Con `pagina`, los filtros van DENTRO del token. Idénticos se aceptan; distintos no. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"categoria debe ser micro, pequena, mediana o grande, o varias separadas por coma."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La lectura tardó más que su techo de tiempo. No se cobra: agrega un filtro. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta. · Ya recibiste en este ciclo todas las empresas que tu plan entrega. No descuenta; `X-Plan-Reset` dice cuándo vuelven. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}}}}},"/v1/prospeccion/conteo":{"get":{"summary":"Prospeccion Conteo","operationId":"prospeccion_conteo_v1_prospeccion_conteo_get","parameters":[{"name":"categoria","in":"query","required":false,"schema":{"type":"string","default":"","title":"Categoria"}},{"name":"tramo_minimo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tramo Minimo"}},{"name":"tramo_maximo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Tramo Maximo"}},{"name":"trabajadores_minimo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Trabajadores Minimo"}},{"name":"trabajadores_maximo","in":"query","required":false,"schema":{"type":"string","default":"","title":"Trabajadores Maximo"}},{"name":"rubro","in":"query","required":false,"schema":{"type":"string","default":"","title":"Rubro"}},{"name":"regimen","in":"query","required":false,"schema":{"type":"string","default":"","title":"Regimen"}},{"name":"actividad","in":"query","required":false,"schema":{"type":"string","default":"","title":"Actividad"}},{"name":"region","in":"query","required":false,"schema":{"type":"string","default":"","title":"Region"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string","default":"","title":"Provincia"}},{"name":"comuna","in":"query","required":false,"schema":{"type":"string","default":"","title":"Comuna"}},{"name":"vigentes","in":"query","required":false,"schema":{"type":"string","default":"","title":"Vigentes"}},{"name":"crecio","in":"query","required":false,"schema":{"type":"string","default":"","title":"Crecio"}}],"responses":{"200":{"description":"Siempre: contar no descuenta, tampoco cuando no calza ninguna. No descuenta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prospeccion Conteo V1 Prospeccion Conteo Get"},"example":{"filtros":{"categoria":["grande"],"trabajadores_minimo":10000,"rubro":["B"],"regimen":[],"comuna":"13101","vigentes":true,"crecio":false},"total":1,"por_categoria":[{"categoria":"grande","nombre":"Gran empresa","empresas":1}],"por_region":[{"codigo":"13","nombre":"Región Metropolitana de Santiago","empresas":1}],"por_rubro":[{"codigo":"B","descripcion":"EXPLOTACION DE MINAS Y CANTERAS","empresas":1}],"fuente":"Nóminas públicas de contribuyentes y nómina anual de empresas, SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"`categoria` no es un tamaño. No descuenta. · Un tramo fuera de la leyenda del SII. No descuenta. · Un mínimo o máximo de trabajadores negativo, o que no cabe en 32 bits. No descuenta. · Un mínimo mayor que su máximo. No descuenta. · `rubro` no es una sección CIIU. No descuenta. · `regimen` no es uno de los publicados. No descuenta. · `region` no es una región de Chile. No descuenta. · `provincia` no es una provincia de Chile. No descuenta. · `comuna` no es una comuna de Chile. No descuenta. · `vigentes` no es `true` ni `false`. No descuenta. · `crecio` no es `true` ni `false`. No descuenta. · El giro se filtra por su código (el mismo `codigo` de las actividades): un entero positivo de 32 bits, no un texto. No descuenta. · Un parámetro llegó dos veces (`?comuna=A&comuna=B`): no se elige uno por ti. El detail nombra el que se repitió. No se cobra. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"categoria debe ser micro, pequena, mediana o grande, o varias separadas por coma."}}}},"503":{"description":"El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta. · La lectura tardó más que su techo de tiempo. No se cobra: agrega un filtro. No descuenta. · La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_no_disponible","detail":"El padrón aún no está cargado; intenta más tarde. Estado del servicio: https://status.datario.cl"}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/v1/vigilancia/novedades":{"get":{"summary":"Novedades","operationId":"novedades_v1_vigilancia_novedades_get","parameters":[{"name":"desde","in":"query","required":false,"schema":{"type":"string","default":"","title":"Desde"}},{"name":"lista","in":"query","required":false,"schema":{"type":"string","default":"","title":"Lista"}},{"name":"limite","in":"query","required":false,"schema":{"type":"string","default":"","title":"Limite"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"string","default":"","title":"Pagina"}}],"responses":{"200":{"description":"Siempre que la key sirva: cada novedad ya se descontó al entregarse, y leerla no descuenta. Vacía mientras el SII no publique nada sobre tus RUT. No descuenta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Novedades V1 Vigilancia Novedades Get"},"example":{"novedades":[],"hay_mas":false,"retenidas":0,"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"422":{"description":"`desde` no es un día. No descuenta. · `lista` no es un id, o no es de una lista tuya. No descuenta. · `limite` no es un entero en el rango. No descuenta. · Un parámetro llegó dos veces (`?lista=A&lista=B`): no se elige uno por ti. El detail nombra el que se repitió. No descuenta. · El token de página llegó adulterado o incompleto. Se pide de nuevo desde la primera. No descuenta. · Con `pagina`, los filtros van DENTRO del token. Idénticos se aceptan; distintos no. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"desde debe ser un día ISO 8601 (YYYY-MM-DD)."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}}}}},"/v1/vigilancia/estado":{"get":{"summary":"Estado","operationId":"estado_v1_vigilancia_estado_get","responses":{"200":{"description":"El estado actual sin cobro. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Estado V1 Vigilancia Estado Get"},"example":{"estado":"detenida","producto_disponible":true,"pendientes_verificacion":0,"novedades_retenidas":0,"ruts_presentes":3,"ruts_ausentes":1,"costo_reactivacion_estimado":3}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}}}}}},"/v1/vigilancia/reactivar":{"post":{"summary":"Reactivar","operationId":"reactivar_v1_vigilancia_reactivar_post","responses":{"200":{"description":"La reactivación queda programada. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reactivar V1 Vigilancia Reactivar Post"},"example":{"estado":"activa","producto_disponible":true,"pendientes_verificacion":3,"novedades_retenidas":0,"ruts_presentes":3,"ruts_ausentes":1,"costo_reactivacion_estimado":3}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}}},"404":{"description":"El monitoreo está apagado: no se crean listas, no entran RUT y no se reactiva. Tus listas, su estado y tus novedades se siguen leyendo, y puedes quitar RUT y borrar listas. No descuenta.","content":{"application/json":{"example":{"error":"operacion_no_disponible","detail":"El monitoreo no está disponible por ahora."}}}},"403":{"description":"Tu plan no incluye esa operación: cada plan trae todo lo del anterior, y en /precios está desde qué plan se incluye cada una. No descuenta. Al cambiar de plan, el acceso nuevo rige desde la consulta siguiente. No descuenta.","content":{"application/json":{"example":{"error":"plan_no_incluye","detail":"Verificación de un RUT monitoreado requiere el plan Starter o uno superior, y tu plan actual no lo incluye. Compara los planes en https://datario.cl/precios."}}}},"409":{"description":"Se está validando la publicación del padrón: no se crean listas, no entran RUT y no se reactiva hasta que termine. Reintenta más tarde. No descuenta. · La cuenta está cerrada: su monitoreo no se reactiva. No descuenta.","content":{"application/json":{"example":{"error":"vigilancia_detenida","detail":"Estamos validando la publicación del padrón. Intenta más tarde."}}}}}}},"/v1/vigilancia/listas":{"get":{"summary":"Listas","operationId":"listas_v1_vigilancia_listas_get","responses":{"200":{"description":"Siempre que la key sirva. Sin listas, la lista viene vacía. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Listas V1 Vigilancia Listas Get"},"example":{"listas":[{"id":"8c2a6d3e-5f4b-4a1c-9e7d-2b3c4d5e6f70","nombre":"proveedores","ruts":3,"al_dia":3,"creada_en":"2026-08-29T04:12:07+00:00"}],"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}}}}},"post":{"summary":"Crear Lista","operationId":"crear_lista_v1_vigilancia_listas_post","responses":{"200":{"description":"La lista se creó. Nace vacía y sin RUT al día que verificar. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Crear Lista V1 Vigilancia Listas Post"},"example":{"id":"8c2a6d3e-5f4b-4a1c-9e7d-2b3c4d5e6f70","nombre":"proveedores","ruts":0,"al_dia":0,"creada_en":"2026-08-29T04:12:07+00:00","fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}}},"404":{"description":"El monitoreo está apagado: no se crean listas, no entran RUT y no se reactiva. Tus listas, su estado y tus novedades se siguen leyendo, y puedes quitar RUT y borrar listas. No descuenta.","content":{"application/json":{"example":{"error":"operacion_no_disponible","detail":"El monitoreo no está disponible por ahora."}}}},"403":{"description":"Tu plan no incluye esa operación: cada plan trae todo lo del anterior, y en /precios está desde qué plan se incluye cada una. No descuenta. Al cambiar de plan, el acceso nuevo rige desde la consulta siguiente. No descuenta.","content":{"application/json":{"example":{"error":"plan_no_incluye","detail":"Verificación de un RUT monitoreado requiere el plan Starter o uno superior, y tu plan actual no lo incluye. Compara los planes en https://datario.cl/precios."}}}},"409":{"description":"Tu monitoreo está detenido: reactívala antes de crear listas o agregar RUT. No descuenta. · Se está validando la publicación del padrón: no se crean listas, no entran RUT y no se reactiva hasta que termine. Reintenta más tarde. No descuenta.","content":{"application/json":{"example":{"error":"vigilancia_detenida","detail":"El monitoreo está detenido. Reactívala para continuar."}}}},"422":{"description":"El cuerpo no es JSON, o no trae los campos con su forma. No descuenta. · El nombre viene vacío o demasiado largo. No descuenta. · Ya tienes otra lista con ese nombre: no se repiten dentro de una cuenta. No descuenta. · Ya tienes el máximo de listas: 20 por cuenta. No descuenta. · El segmento no trae ningún filtro, trae una clave que no es de las tres, un código que no existe o demasiados valores. No descuenta.","content":{"application/json":{"example":{"error":"cuerpo_invalido","detail":"El cuerpo debe ser un objeto JSON con la forma documentada."}}}},"413":{"description":"El JSON pasa de 16.384 bytes. Este cuerpo es un nombre y, si la lista es de mercado, sus filtros: nada de lo que se manda acá pesa tanto. No descuenta.","content":{"application/json":{"example":{"error":"cuerpo_demasiado_grande","detail":"El cuerpo supera el tope de bytes de esta petición."}}}}}}},"/v1/vigilancia/listas/{lista_id}":{"get":{"summary":"Lista","operationId":"lista_v1_vigilancia_listas__lista_id__get","parameters":[{"name":"lista_id","in":"path","required":true,"schema":{"type":"string","title":"Lista Id"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"string","default":"","title":"Pagina"}}],"responses":{"200":{"description":"La lista es tuya. No descuenta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Lista V1 Vigilancia Listas  Lista Id  Get"},"example":{"id":"8c2a6d3e-5f4b-4a1c-9e7d-2b3c4d5e6f70","nombre":"proveedores","ruts":1,"al_dia":1,"creada_en":"2026-08-29T04:12:07+00:00","items":[{"rut":"61704000-K","rut_formateado":"61.704.000-K","etiqueta":"casa matriz","agregado_el":"2026-08-29T04:12:07+00:00","verificado_el":"2026-08-29T04:12:07+00:00","presente":true,"en_pausa":false,"publicacion_verificada":"2026-08-05T15:36:37+00:00"}],"hay_mas":false,"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"404":{"description":"El id no es de una lista tuya. La de otra cuenta tampoco existe para ti. No descuenta.","content":{"application/json":{"example":{"error":"lista_no_encontrada","detail":"Esa lista no existe en tu cuenta."}}}},"422":{"description":"El token de página llegó adulterado o incompleto. Se pide de nuevo desde la primera. No descuenta.","content":{"application/json":{"example":{"error":"parametros_invalidos","detail":"pagina no es válida: pide la primera página sin ese parámetro."}}}}}},"delete":{"summary":"Borrar Lista","operationId":"borrar_lista_v1_vigilancia_listas__lista_id__delete","parameters":[{"name":"lista_id","in":"path","required":true,"schema":{"type":"string","title":"Lista Id"}}],"responses":{"200":{"description":"La lista era tuya y se borró. No descuenta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Borrar Lista V1 Vigilancia Listas  Lista Id  Delete"},"example":{"id":"8c2a6d3e-5f4b-4a1c-9e7d-2b3c4d5e6f70","borrada":true,"ruts":3,"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"404":{"description":"El id no es de una lista tuya. La de otra cuenta tampoco existe para ti. No descuenta.","content":{"application/json":{"example":{"error":"lista_no_encontrada","detail":"Esa lista no existe en tu cuenta."}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/vigilancia/listas/{lista_id}/rut":{"post":{"summary":"Alta Rut","operationId":"alta_rut_v1_vigilancia_listas__lista_id__rut_post","parameters":[{"name":"lista_id","in":"path","required":true,"schema":{"type":"string","title":"Lista Id"}}],"responses":{"200":{"description":"Entraron RUT nuevos: descuenta uno por cada uno. Si todos ya estaban, descuenta cero, la llamada vale igual y las cabeceras `X-Plan-*` y `X-Charged` no viajan: no hubo cobro que las traiga. Descuenta una consulta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Alta Rut V1 Vigilancia Listas  Lista Id  Rut Post"},"example":{"agregados":2,"repetidos":0,"descartados":{"mal_escritos":0,"no_disponibles":0,"sobre_el_tope":0},"total":2,"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"X-Plan-Limit":{"schema":{"type":"string"}},"X-Plan-Remaining":{"schema":{"type":"string"}},"X-Plan-Reset":{"schema":{"type":"string"}},"X-Balance-CLP":{"schema":{"type":"string"}},"X-Charged":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta. · El padrón todavía no tiene datos que responder. Es excepcional: reintenta más tarde y, si sigue, mira el estado del servicio. No descuenta.","content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"404":{"description":"El monitoreo está apagado: no se crean listas, no entran RUT y no se reactiva. Tus listas, su estado y tus novedades se siguen leyendo, y puedes quitar RUT y borrar listas. No descuenta. · El id no es de una lista tuya. La de otra cuenta tampoco existe para ti. No descuenta.","content":{"application/json":{"example":{"error":"operacion_no_disponible","detail":"El monitoreo no está disponible por ahora."}}}},"403":{"description":"Tu plan no incluye esa operación: cada plan trae todo lo del anterior, y en /precios está desde qué plan se incluye cada una. No descuenta. Al cambiar de plan, el acceso nuevo rige desde la consulta siguiente. No descuenta. · Tu cuenta ya monitorea todos los RUT que su plan incluye —Starter tiene tope; Pro y superiores no— y ninguno de los que mandas cabe. No crea ni descuenta nada. Si todavía caben algunos, la carga entra parcial y el resto sale en `descartados.sobre_el_tope`. No descuenta.","content":{"application/json":{"example":{"error":"plan_no_incluye","detail":"Verificación de un RUT monitoreado requiere el plan Starter o uno superior, y tu plan actual no lo incluye. Compara los planes en https://datario.cl/precios."}}}},"409":{"description":"Tu monitoreo está detenido: reactívala antes de crear listas o agregar RUT. No descuenta. · Se está validando la publicación del padrón: no se crean listas, no entran RUT y no se reactiva hasta que termine. Reintenta más tarde. No descuenta.","content":{"application/json":{"example":{"error":"vigilancia_detenida","detail":"El monitoreo está detenido. Reactívala para continuar."}}}},"422":{"description":"La lista es de mercado. Para monitorear RUT, crea una lista sin segmento. No descuenta. · El cuerpo no es JSON, o no trae los campos con su forma. No descuenta. · La lista llegaría a más de 50.000 RUT, o la carga trae más de 100.000 filas. No crea ni descuenta nada. No descuenta.","content":{"application/json":{"example":{"error":"lista_de_mercado","detail":"Esa lista monitorea un mercado: no se le agregan RUT."}}}},"413":{"description":"El JSON pasa de 5,0 MB. Mándalos en varias cargas. No descuenta.","content":{"application/json":{"example":{"error":"cuerpo_demasiado_grande","detail":"El cuerpo supera el tope de bytes de esta petición."}}}},"402":{"description":"No quedan consultas en el plan y el saldo no cubre las que faltan, o el saldo no cubre lo que la operación cobra en pesos. Nada se cobra. No descuenta. · El plan no alcanza, hay saldo, y el interruptor «usar mi saldo automáticamente» está apagado. Nada se cobra. No descuenta.","content":{"application/json":{"example":{"error":"sin_saldo","detail":"Tu plan y tu saldo no alcanzan para esta operación. Las consultas del plan renuevan el día que cumple el mes (X-Plan-Reset); para seguir ahora, recarga saldo (no vence) en https://datario.cl/panel/recargas, o contrata un plan más grande en https://datario.cl/panel/planes, que sale más barato por consulta"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}}}}},"/v1/vigilancia/listas/{lista_id}/rut/{rut_crudo}":{"delete":{"summary":"Baja Rut","operationId":"baja_rut_v1_vigilancia_listas__lista_id__rut__rut_crudo__delete","parameters":[{"name":"lista_id","in":"path","required":true,"schema":{"type":"string","title":"Lista Id"}},{"name":"rut_crudo","in":"path","required":true,"schema":{"type":"string","title":"Rut Crudo"}}],"responses":{"200":{"description":"El RUT estaba en la lista y salió. No descuenta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Baja Rut V1 Vigilancia Listas  Lista Id  Rut  Rut Crudo  Delete"},"example":{"rut":"61704000-K","quitado":true,"fuente":"Tus listas, cruzadas con el historial de cambios del padrón del SII","padron_publicado":"2026-08-05T15:36:37+00:00","consultado_en":"2026-08-29T04:12:07+00:00"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"429":{"description":"Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","content":{"application/json":{"example":{"error":"limite_de_velocidad","detail":"Superaste las consultas por minuto de tu plan: X-RateLimit-Limit dice cuántas y Retry-After cuánto esperar."}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}}},"422":{"description":"El dígito verificador no corresponde al cuerpo. No se cobra: no hubo consulta. No descuenta.","content":{"application/json":{"example":{"error":"rut_invalido","detail":"El RUT no es válido."}}}},"404":{"description":"El id no es de una lista tuya. La de otra cuenta tampoco existe para ti. No descuenta. · El RUT no estaba en la lista: no hay nada que quitar. No descuenta.","content":{"application/json":{"example":{"error":"lista_no_encontrada","detail":"Esa lista no existe en tu cuenta."}}}}}}},"/v1/soporte/reto":{"post":{"summary":"Reto","operationId":"reto_v1_soporte_reto_post","responses":{"200":{"description":"Cuando el reto queda anotado con tu key. Sin descontar consultas: no trae cabeceras de consumo. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Reto V1 Soporte Reto Post"},"example":{"reto":"9f1c0a7e4b2d4c3f8e6a5b4c3d2e1f0a","recibido":"2026-08-29T04:12:07+00:00"}}}},"401":{"description":"No mandaste el header, o no empieza con dtr_. No descuenta. · La key viajó bien pero ya no sirve: la revocaste o la rotaste. No descuenta.","content":{"application/json":{"example":{"error":"api_key_invalida","detail":"Falta la API key: envíala en el header Authorization: Bearer dtr_…."}}}},"413":{"description":"El JSON pasa de 1.024 bytes. Trae un solo campo, el reto: nada de lo que se manda acá pesa tanto. No descuenta.","content":{"application/json":{"example":{"error":"cuerpo_demasiado_grande","detail":"El cuerpo supera el tope de bytes de esta petición."}}}},"422":{"description":"El cuerpo no es JSON, o no trae los campos con su forma. No descuenta. · Falta el campo `reto`, o no es el que te mandó soporte. Cópialo tal cual, sin espacios ni cambios. No descuenta.","content":{"application/json":{"example":{"error":"cuerpo_invalido","detail":"El cuerpo debe ser un objeto JSON con la forma documentada."}}}},"429":{"description":"Tu cuenta ya hizo 10 intentos hoy, sumando todas sus keys: cuenta cada intento con un cuerpo válido, también los que rebotaron por el límite por minuto. No descuenta ni anota nada. Vuelve a cero a la medianoche de Chile, y `Retry-After` dice cuánto falta. No descuenta. · Fuiste más rápido que las consultas por minuto de tu plan. `Retry-After` dice cuánto esperar. No descuenta.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"retos_agotados","detail":"Tu cuenta ya usó hoy todos los intentos de presentar un reto de soporte: Retry-After dice cuánto falta para volver a intentarlo."}}}},"503":{"description":"La llamada llegó mientras se aplicaba una publicación nueva del padrón y esperó todo lo que espera sin poder leerlo. No descuenta: si ya se había descontado, se devuelve. Pasa solo mientras esa publicación se aplica, casi siempre de madrugada: reintenta pasado el `Retry-After`. No descuenta.","headers":{"X-RateLimit-Limit":{"schema":{"type":"string"}},"X-RateLimit-Remaining":{"schema":{"type":"string"}},"X-RateLimit-Reset":{"schema":{"type":"string"}},"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"example":{"error":"padron_actualizandose","detail":"El padrón se está actualizando: reintenta en unos segundos (Retry-After). Si sigue fallando, mira https://status.datario.cl"}}}}}}},"/graphql":{"get":{"summary":"Graphql Get","operationId":"graphql_get_graphql_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Graphql Post","operationId":"graphql_post_graphql_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/soap/v1":{"get":{"summary":"Wsdl","description":"El WSDL vivo — con `?wsdl` (la convención) o sin nada, da lo mismo.","operationId":"wsdl_soap_v1_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Soap Post","operationId":"soap_post_soap_v1_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/webhooks/github/secret-scanning":{"post":{"summary":"Secret Scanning","description":"Revoca las keys que GitHub encontró expuestas y le avisa al dueño.\n\nContesta una entrada POR TOKEN y en el mismo orden: es el contrato del\nprograma, y GitHub le muestra esa etiqueta a quien filtró la credencial.\nToda key NUESTRA es `true_positive`, esté viva o ya apagada: la etiqueta\ndice de quién era, no si este aviso la apagó — eso lo dice\n`Revocacion.recien`, y solo gobierna el correo.","operationId":"secret_scanning_webhooks_github_secret_scanning_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Secret Scanning Webhooks Github Secret Scanning Post"}}}}}}},"/v1/estado":{"get":{"summary":"Estado","operationId":"estado_v1_estado_get","responses":{"200":{"description":"Siempre que la base responda. Sin API key y sin descontar. No descuenta.","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Estado V1 Estado Get"},"example":{"estado":"operativo","comprobado_en":"2026-08-29T04:12:07+00:00","version":"1ad3ecd","padron":{"publicado":"2026-08-05T15:36:37+00:00","revisado":"2026-09-05","corridas_fallidas":0},"concursal":{"actualizado_al":"2026-09-09","revisado":"2026-09-10","corridas_fallidas":0},"correos":{"atraso_s":0,"sin_salir_s":0},"vigilancia":{"cruce_pendiente_s":0,"resumen_abierto_s":0},"mecanismos":[{"id":"soap","ok":true,"causa":""},{"id":"graphql","ok":true,"causa":""},{"id":"mcp","ok":true,"causa":""}],"enlaces":{"estado":"https://status.datario.cl","resumen":"https://status.datario.cl/api/v2/summary.json"}}}}},"503":{"description":"La API no está atendiendo. Reintentar en el acto devuelve lo mismo: espera unos segundos. No descuenta.","content":{"application/json":{"example":{"error":"no_disponible","detail":"La API no puede leer su base de datos en este momento; intenta en unos minutos."}}}}}}},"/healthz":{"get":{"summary":"Healthz","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Healthz Healthz Get"}}}}}}},"/readyz":{"get":{"summary":"Readyz","description":"Listo para tráfico: la base de datos responde y el catálogo de\noperaciones se leyó (run-3). Es el startup probe: sin lo segundo, una\ninstancia nueva servía con la declaración —sin los retiros que la base\ndice— hasta su primera lectura.","operationId":"readyz_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Readyz Readyz Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}