Indicadores Argentina Persona API
The Persona API from Indicadores Argentina — 1 operation(s) for persona.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/indicadores-ar:indicadores-ar-persona-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Indicadores Ar Persona API
version: '1.1'
contact:
email: contacto@indicadores.ar
url: https://indicadores.ar/api-empresas
description: 'Operations tagged Persona across 2 of this provider''s published API definitions: indicadores-ar-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://indicadores.ar/v1
security:
- apiKey: []
tags:
- name: Persona
paths:
/persona:
get:
operationId: persona
summary: Ficha de una persona por CUIT o por su id
description: '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, y una clave sin actividad (un CUIL laboral) también, con `fiscal` en null y su situación BCRA. Si el CUIT es de una empresa, la respuesta es su ficha de empresa con `ficha: empresa`, cobrada como /empresa.
Costo: 1 crédito.'
parameters:
- name: cuit
in: query
description: CUIT/CUIL de la persona (11 dígitos, con o sin guiones). Uno de cuit o id.
schema:
type: string
example: '30500010912'
- name: id
in: query
description: El `persona_id` de /busqueda-personas o de los dirigentes de /empresa, en lugar del CUIT. Uno de cuit o id.
schema:
type: integer
example: '81234'
responses:
'200':
description: Ficha de una persona por CUIT o por su id.
content:
application/json:
schema:
type: object
properties:
ficha:
type: string
enum:
- empresa
- persona
description: '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:
type:
- string
- 'null'
description: Explica por qué la ficha no es la del endpoint pedido. Null cuando lo es.
persona_id:
type:
- integer
- 'null'
description: Id de la persona (sirve para `/persona?id=`); null cuando la ficha sale sólo del padrón fiscal.
cuit:
type: string
alcance:
type: string
enum:
- registro
- padron
description: '`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. Una clave del padrón SIN actividad (un CUIL laboral, una inscripción dada de baja) también responde con `padron`: `fiscal` en null, la situación crediticia y el nombre que le da el BCRA. Cuesta lo mismo.'
alcance_nota:
type:
- string
- 'null'
description: Explica el alcance cuando es `padron`; null en una ficha completa.
nombre_completo:
type: string
description: 'En una clave sin actividad es el nombre que le da la Central de Deudores del BCRA: vacío mientras la consulta está en curso (`bcra_estado`) o si el BCRA no la registra.'
funcionario_publico:
type: boolean
description: Declaró como funcionario/a ante la Oficina Anticorrupción en algún año; no implica que lo sea hoy.
funcionario_publico_anio:
type:
- integer
- 'null'
description: Año de su última declaración jurada; null si no declaró.
funcionario_publico_cargo:
type:
- string
- 'null'
description: Cargo de esa última declaración; null si no declaró.
fiscal:
type:
- object
- 'null'
properties:
condicion:
type:
- string
- 'null'
description: monotributo, responsable_inscripto, autonomo, con_actividad…
monotributo_categoria:
type:
- string
- 'null'
description: 'Letra A-K: el techo de facturación anual declarado. Del padrón masivo de ARCA.'
monotributo_actividad:
type:
- string
- 'null'
description: '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:
type:
- string
- 'null'
enum:
- AC
- EX
- NI
- NA
- XN
- AN
- null
description: '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:
type:
- string
- 'null'
enum:
- AC
- EX
- NI
- NC
- null
description: 'Código de ARCA: `AC` inscripto, `EX` exento, `NI` no inscripto, `NC` no corresponde. Null = en blanco.'
actividad:
type:
- string
- 'null'
estado:
type:
- string
- 'null'
description: activa | inactiva | unknown
domicilio:
type:
- string
- 'null'
description: Domicilio fiscal declarado.
empleador:
type:
- boolean
- 'null'
description: '`true` = inscripta como empleadora (aportes y contribuciones). `null` = el padrón la publica en blanco.'
empleador_al:
type:
- string
- 'null'
format: date
description: Fecha del corte del padrón al que corresponde `empleador`.
padron_al:
type:
- string
- 'null'
format: date
description: Fecha del corte del padrón masivo de ARCA.
description: '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): la ficha trae igual su situación crediticia. 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.'
empresas:
type: array
items:
type: object
properties:
cuit:
type: string
razon_social:
type: string
forma_legal:
type:
- string
- 'null'
jurisdiccion:
type:
- string
- 'null'
roles:
type: array
items:
type: string
description: Los cargos, sin fechas (lo mismo que `cargos[].rol`).
cargos:
type: array
items:
type: object
properties:
rol:
type: string
suplente:
type: boolean
description: El cargo es suplente.
desde:
type:
- string
- 'null'
format: date
description: Fecha del acto que lo designó.
hasta:
type:
- string
- 'null'
format: date
description: Fecha del cese. Sin cese propio, la de una renuncia posterior de la persona en la empresa.
fuente:
type: string
enum:
- boletin
- registro
description: '`boletin` = sale de un aviso societario publicado. `registro` = registro acumulado de autoridades, sin fecha de designación ni de cese.'
description: Un cargo por rol y carácter con su período, con la misma regla que `dirigentes[].cargos` de `/empresa`.
estado:
type: string
enum:
- sin_cese
- cesado
- sin_fecha
description: '`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:
type:
- string
- 'null'
format: date
description: El último cese, cuando `estado` es `cesado`.
fuente:
type: string
enum:
- boletin
- registro
description: '`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.'
description: '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`.'
empresas_total:
type: integer
description: Cuántas empresas tiene vinculadas la persona. Mayor que el largo de `empresas` cuando la lista vino recortada.
bcra_consultado_el:
type:
- string
- 'null'
format: date-time
description: 'Última lectura buena de la central de deudores para este CUIT. Null = todavía no se leyó bien: en ese caso `deudas_bcra` y `cheques_rechazados` en null NO afirman que no haya deuda; `bcra_estado` dice si hay que volver a pedir en minutos o más tarde.'
bcra_estado:
type: string
enum:
- vigente
- en_consulta
- fallo_temporal
- no_corresponde
description: 'En qué está la consulta a la central de deudores. `vigente`: la lectura de `bcra_consultado_el` está al día. `en_consulta`: no hay lectura al día y este pedido la encoló con prioridad; volvé a pedir la ficha en unos minutos. `fallo_temporal`: el BCRA no contestó en el último intento; se reintenta solo desde `bcra_reintentar_desde`, y si había una lectura buena anterior los bloques traen esa. `no_corresponde` (sólo /v1/persona): la identidad del CUIT no está corroborada y no se consulta.'
bcra_reintentar_desde:
type:
- string
- 'null'
format: date-time
description: Desde cuándo vuelve a consultarse el BCRA. Sólo con `bcra_estado = fallo_temporal`; null en los demás.
deudas_bcra:
type:
- object
- 'null'
properties:
periodo:
type: string
description: Período informado (AAAAMM).
peor_situacion:
type: integer
description: '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:
type: integer
description: Situación de la entidad que concentra la mayor deuda del período. 1 = normal … 5 = irrecuperable.
situacion_principal_label:
type: string
deuda_total_miles:
type: number
description: Deuda total en miles de pesos.
entidades:
type: integer
description: Cantidad de entidades que informan deuda.
entidades_detalle:
type: array
items:
type: object
properties:
entidad:
type: string
situacion:
type: integer
description: 1 = normal … 5 = irrecuperable.
situacion_label:
type: string
deuda_miles:
type: number
dias_atraso:
type: integer
refinanciado:
type: boolean
en_juicio:
type: boolean
description: Deuda banco por banco del período más reciente (hasta 50, por situación y monto).
description: Riesgo crediticio BCRA de la persona. Sólo se incluye cuando la identidad del CUIT está corroborada por nombre contra el padrón fiscal.
cheques_rechazados:
type:
- object
- 'null'
properties:
total:
type: integer
impagos:
type: integer
detalle:
type: array
items:
type: object
properties:
numero:
type: string
entidad:
type: string
fecha:
type: string
format: date
monto:
type: string
causal:
type:
- string
- 'null'
pagado:
type: boolean
fecha_pago:
type:
- string
- 'null'
format: date
description: Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero).
description: Cheques rechazados informados por el BCRA. Null sin registros.
consultado_el:
type: string
format: date-time
'400':
$ref: '#/components/responses/ParametroInvalido'
'401':
$ref: '#/components/responses/NoAutorizado'
'402':
$ref: '#/components/responses/SinCreditos'
'404':
$ref: '#/components/responses/NoEncontrado'
'429':
$ref: '#/components/responses/RateLimit'
'500':
$ref: '#/components/responses/ErrorInterno'
'503':
$ref: '#/components/responses/NoDisponible'
tags:
- Persona
servers:
- url: https://indicadores.ar/v1
components:
responses:
RateLimit:
description: limite_de_requests_excedido (por minuto), limite_diario_gratuito_excedido (endpoints gratis) o limite_diario_autoservicio_excedido (cupo diario de créditos por cuenta).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NoEncontrado:
description: No encontrado.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NoAutorizado:
description: api_key_faltante, api_key_malformada (la key llegó cortada o con otro formato) o api_key_invalida (no existe o fue revocada).
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
SinCreditos:
description: Créditos insuficientes.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ParametroInvalido:
description: Parámetro inválido.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ErrorInterno:
description: error_interno. Reintentar; no se cobra.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NoDisponible:
description: 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) o consulta_demorada (la búsqueda superó su tope de tiempo). Reintentar; no se cobra.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Error:
type: object
properties:
error:
type: string
securitySchemes:
apiKey:
type: apiKey
name: api-key
in: header
description: API key creada en https://indicadores.ar/api-empresas
x-refined-from:
- indicadores-ar-openapi.json
- openapi.json