--- agentTools: projectIndex: https://docs.boostr.cl/llms.txt --- # 🔐 Obtener el nombre Busca el nombre de la persona en sii.cl y actividades comerciales > 📘 Este servicio requiere usar un API KEY > > [Pídela aquí](https://docs.boostr.cl/reference/pricing) Este servicio permite buscar en SII el nombre de la persona de acuerdo al RUT ingresado, sólo devuelve información de personas que hayan iniciado actividades y sean mayor de edad. El RUT puede venir en formato: * 111111111 * 11111111-1 * 11.111.111-1 El dígito verificador es obligatorio, si no lo conoce puede obtenerlo utilizando nuestro [generador de dígito verificador.](https://docs.boostr.cl/reference/rut-genera-dv) Los siguientes datos dependen del plan contratado: * activities * first\_name * last\_name * second\_last\_name * activities ### Inteligencia Artificial SII entrega el nombre completo todo junto en un dato, este se incluye en el campos `name`. Para poder generar los campos `first_name`, `last_name` y `second_last_name` utilizamos inteligencia artificial con un modelo entrenado en el proceso de textos, tiene una alta tasa de éxito (sobre el 95%) aunque esto no descarta que para nombres muy atípicos el resultado no sea el esperado. > 📘 Información de tu API KEY > > Ingresa a y junto con tu API KEY podrás saber la cantidad de consultas disponibles, posibles bloqueos, entre otras cosas. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "API", "version": "1.0" }, "servers": [ { "url": "https://api.boostr.cl/" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-API-KEY", "in": "header" } } }, "security": [ { "sec0": [] } ], "paths": { "/rut/name/{rut}.json": { "get": { "summary": "🔐 Obtener el nombre", "description": "Busca el nombre de la persona en sii.cl y actividades comerciales", "operationId": "rut-get-name", "parameters": [ { "name": "rut", "in": "path", "description": "RUT para buscar el nombre.", "schema": { "type": "string", "default": "16.163.631-2" }, "required": true } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n\t\"status\": \"success\",\n\t\"data\": {\n\t\t\"document\": \"16163631\",\n\t\t\"dv\": \"2\",\n\t\t\"name\": \"GABRIEL BORIC FONT\",\n\t\t\"activities\": [\n\t\t\t{\n\t\t\t\t\"activity\": \"ACTIVIDADES DE ARTISTAS REALIZADAS DE FORMA INDEPENDIENTE: ACTORES, MU\",\n\t\t\t\t\"code\": \"900003\",\n\t\t\t\t\"category\": \"Segunda\",\n\t\t\t\t\"iva\": \"No\",\n\t\t\t\t\"date\": \"28-03-2019\"\n\t\t\t}\n\t\t],\n\t\t\"first_name\": \"GABRIEL\",\n\t\t\"last_name\": \"BORIC\",\n\t\t\"second_last_name\": \"FONT\",\n\t\t\"type\": \"person\"\n\t}\n}" }, "Rut inválido": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"U-02\",\n \"message\": \"Rut inválido\"\n}" }, "Origen offline": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"U-03\",\n \"message\": \"Error desde el origen, vuelva a intentar.\"\n}" }, "Rut not found": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"U-04\",\n \"message\": \"No se logró obtener el nombre.\"\n}" } }, "schema": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "example": "success" }, "data": { "type": "object", "properties": { "document": { "type": "string", "example": "16163631" }, "dv": { "type": "string", "example": "2" }, "name": { "type": "string", "example": "GABRIEL BORIC FONT" }, "activities": { "type": "array", "items": { "type": "object", "properties": { "activity": { "type": "string", "example": "ACTIVIDADES DE ARTISTAS REALIZADAS DE FORMA INDEPENDIENTE: ACTORES, MU" }, "code": { "type": "string", "example": "900003" }, "category": { "type": "string", "example": "Segunda" }, "iva": { "type": "string", "example": "No" }, "date": { "type": "string", "example": "28-03-2019" } } } }, "first_name": { "type": "string", "example": "GABRIEL" }, "last_name": { "type": "string", "example": "BORIC" }, "second_last_name": { "type": "string", "example": "FONT" }, "type": { "type": "string", "example": "person" } } } } }, { "title": "Rut inválido", "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "U-02" }, "message": { "type": "string", "example": "Rut inválido" } } }, { "title": "Origen offline", "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "U-03" }, "message": { "type": "string", "example": "Error desde el origen, vuelva a intentar." } } }, { "title": "Rut not found", "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "U-04" }, "message": { "type": "string", "example": "No se logró obtener el nombre." } } } ] } } } }, "429": { "description": "429", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"status\": \"error\",\n \"data\": \"\",\n \"code\": \"RATELIMIT\",\n \"message\": \"429 Too Many Request\",\n \"details\": \"Superaste el límite máximo permitido.\"\n}" } }, "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "data": { "type": "string", "example": "" }, "code": { "type": "string", "example": "RATELIMIT" }, "message": { "type": "string", "example": "429 Too Many Request" }, "details": { "type": "string", "example": "Superaste el límite máximo permitido." } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": false, "proxy-enabled": false }, "x-readme-fauxas": true, "_id": "654e7dc803529d00186e828b:6585f1741839960050fceb76" } ```