--- title: "Ficha de una persona por CUIT." method: GET path: "/persona" --- # Ficha de una persona por CUIT. `GET /persona` ## Request - Base URL: `https://indicadores.ar/v1` - URL: `https://indicadores.ar/v1/persona` - Auth: API key in header `api-key` Identidad, condición fiscal (monotributo, responsable inscripto o autónomo, con actividad y domicilio), todas sus empresas con los roles que ocupa y su situación BCRA cuando la identidad del CUIT está corroborada. Una persona que sólo está en el padrón fiscal responde igual con `alcance: padron` y `empresas` vacío. Si el CUIT es de una empresa, la respuesta es su ficha de empresa con `ficha: empresa`, cobrada como /empresa. Costo: 1 crédito. ## Query parameters - `cuit` string, required ## Response `200` Ficha de una persona por CUIT. - object - `ficha` 'empresa' | 'persona': Qué ficha es la respuesta. `persona` salvo cuando el CUIT es de una empresa: ahí la respuesta es la ficha de empresa (la misma de /v1/empresa), cobrada como tal. - `ficha_nota` string, nullable: Explica por qué la ficha no es la del endpoint pedido. Null cuando lo es. - `cuit` string - `alcance` 'registro' | 'padron': `registro` = la persona aparece en actos societarios y la ficha es completa. `padron` = sólo figura en el padrón fiscal (monotributistas, unipersonales, autónomos): la ficha trae identidad, condición fiscal y situación crediticia, y `empresas` viene vacío porque no hay archivo del que sacarlo. Cuesta lo mismo. - `alcance_nota` string, nullable: Explica el alcance cuando es `padron`; null en una ficha completa. - `nombre_completo` string - `funcionario_publico` boolean: Declaró como funcionario/a ante la Oficina Anticorrupción en algún año; no implica que lo sea hoy. - `funcionario_publico_anio` integer, nullable: Año de su última declaración jurada; null si no declaró. - `funcionario_publico_cargo` string, nullable: Cargo de esa última declaración; null si no declaró. - `fiscal` object, nullable: Condición fiscal ante ARCA: el padrón masivo (todo el país, corte mensual) da condición, categoría de monotributo y si es empleadora; el padrón en vivo agrega actividad, estado y domicilio a demanda. Null cuando la persona no es un actor económico (sin ninguna inscripción). Sólo datos de actividad fiscal: nada demográfico, nunca el DNI. Baja a pedido del titular (Ley 25.326, art. 27) en /aviso-legal. - `condicion` string, nullable: monotributo, responsable_inscripto, autonomo, con_actividad… - `monotributo_categoria` string, nullable: Letra A-K: el techo de facturación anual declarado. Del padrón masivo de ARCA. - `monotributo_actividad` string, nullable: Actividad del monotributo, código de ARCA: `01` comercial, `02` profesional, `03` servicios u oficio, `04` industrial, `05` agropecuaria, `06` otros, `07` eventual, `08` prestación de servicios o locación, `09` otras actividades, `10` venta de cosas muebles, `11` agricultura familiar. Null si no es monotributista. - `iva` 'AC' | 'EX' | 'NI' | 'NA' | 'XN' | 'AN', nullable: Código de ARCA: `AC` responsable inscripto, `EX` exento, `NI` no inscripto, `NA` no alcanzado, `XN` exento no alcanzado, `AN` activo no alcanzado. Null = en blanco. - `ganancias` 'AC' | 'EX' | 'NI' | 'NC', nullable: Código de ARCA: `AC` inscripto, `EX` exento, `NI` no inscripto, `NC` no corresponde. Null = en blanco. - `actividad` string, nullable - `estado` string, nullable: activa | inactiva | unknown - `domicilio` string, nullable: Domicilio fiscal declarado. - `empleador` boolean, nullable: `true` = inscripta como empleadora (aportes y contribuciones). `null` = el padrón la publica en blanco. - `empleador_al` string, date, nullable: Fecha del corte del padrón al que corresponde `empleador`. - `padron_al` string, date, nullable: Fecha del corte del padrón masivo de ARCA. - `empresas` object[]: Empresas vinculadas con los cargos que ocupa u ocupó en cada una. Trae hasta 100, por razón social; `empresas_total` dice cuántas son. Que figure no quiere decir que siga: mirar `estado`. - `cuit` string - `razon_social` string - `forma_legal` string, nullable - `jurisdiccion` string, nullable - `roles` string[]: Los cargos, sin fechas (lo mismo que `cargos[].rol`). - `cargos` object[]: Un cargo por rol y carácter con su período, con la misma regla que `dirigentes[].cargos` de `/empresa`. - `rol` string - `suplente` boolean: El cargo es suplente. - `desde` string, date, nullable: Fecha del acto que lo designó. - `hasta` string, date, nullable: Fecha del cese. Sin cese propio, la de una renuncia posterior de la persona en la empresa. - `fuente` 'boletin' | 'registro': `boletin` = sale de un aviso societario publicado. `registro` = registro acumulado de autoridades, sin fecha de designación ni de cese. - `estado` 'sin_cese' | 'cesado' | 'sin_fecha': `sin_cese` = algún cargo sale de un aviso y no tiene cese publicado. `cesado` = todos sus cargos cesaron (o renunció después de que lo designaran); la fecha está en `hasta`. `sin_fecha` = lo único abierto es del registro sin fecha: no afirma que siga. - `hasta` string, date, nullable: El último cese, cuando `estado` es `cesado`. - `fuente` 'boletin' | 'registro': `registro` = en esta empresa sólo figura en el registro acumulado de autoridades, sin fecha de designación ni de cese y sin aviso: alguna vez figuró, no que siga. `boletin` = algún cargo sale de un aviso societario publicado. - `empresas_total` integer: Cuántas empresas tiene vinculadas la persona. Mayor que el largo de `empresas` cuando la lista vino recortada. - `bcra_consultado_el` string, date-time, nullable: Última lectura buena de la central de deudores para este CUIT. Null = todavía no se consultó: en ese caso `deudas_bcra` y `cheques_rechazados` en null NO afirman que no haya deuda. Pedir la ficha encola la consulta y una llamada posterior (minutos) la trae. - `deudas_bcra` object, nullable: Riesgo crediticio BCRA de la persona. Sólo se incluye cuando la identidad del CUIT está corroborada por nombre contra el padrón fiscal. - `periodo` string: Período informado (AAAAMM). - `peor_situacion` integer: 1 = normal … 5 = irrecuperable. Es el MÁXIMO entre las entidades que informan: una deuda residual chica en situación 5 lo pone en 5 aunque el 99% de la deuda esté en 1. Para leer cómo está la empresa usá `situacion_principal`. - `situacion_principal` integer: Situación de la entidad que concentra la mayor deuda del período. 1 = normal … 5 = irrecuperable. - `situacion_principal_label` string - `deuda_total_miles` number: Deuda total en miles de pesos. - `entidades` integer: Cantidad de entidades que informan deuda. - `entidades_detalle` object[]: Deuda banco por banco del período más reciente (hasta 50, por situación y monto). - `entidad` string - `situacion` integer: 1 = normal … 5 = irrecuperable. - `situacion_label` string - `deuda_miles` number - `dias_atraso` integer - `refinanciado` boolean - `en_juicio` boolean - `cheques_rechazados` object, nullable: Cheques rechazados informados por el BCRA. Null sin registros. - `total` integer - `impagos` integer - `detalle` object[]: Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero). - `numero` string - `entidad` string - `fecha` string, date - `monto` string - `causal` string, nullable - `pagado` boolean - `fecha_pago` string, date, nullable - `consultado_el` string, date-time ## Other responses - `400`: Parámetro inválido. - `401`: api_key_faltante, api_key_malformada (la key llegó cortada o con otro formato) o api_key_invalida (no existe o fue revocada). - `402`: Créditos insuficientes. - `404`: No encontrado. - `429`: limite_de_requests_excedido (por minuto), limite_diario_gratuito_excedido (endpoints gratis) o limite_diario_autoservicio_excedido (cupo diario de créditos por cuenta). - `500`: error_interno. Reintentar; no se cobra. - `503`: servicio_no_disponible (transitorio, con Retry-After) o padron_no_disponible (el CUIT no está en nuestro padrón y el padrón fiscal no respondió a tiempo). Reintentar; no se cobra. --- [API](https://skmtc.dev/indicadores/apis/api-de-indicadores-argentina.md) · [All operations](https://skmtc.dev/indicadores/apis/api-de-indicadores-argentina/llms.txt) · [OpenAPI document](https://skmtc.dev/indicadores/apis/api-de-indicadores-argentina/revisions/8bc14951b48d?raw)