Documentación de la API

REST, JSON en castellano. Base URL https://indicadores.ar/v1.

Spec OpenAPI (JSON)Descargar OpenAPI (YAML)Mi API key

Empezá en 30 segundos

curl "https://indicadores.ar/v1/empresa?cuit=30500010912" \
  -H "api-key: TU_API_KEY"

¿Sin key todavía? Creá tu cuenta gratis: la primera key viene con 100 créditos.

Autenticación

Header api-key (o Authorization: Bearer) en cada request. La key se crea en tu cuenta; va de servidor a servidor, nunca en un front-end.

Créditos y costos

No se cobra lo que no llega ni los campos que vienen vacíos. Sólo el 200 se cobra; los errores no, y tampoco la respuesta que no llegó a entregarse (si la conexión se cortó o la consulta superó el tiempo de espera, la llamada no se debita). campos= agrega bloques que suman créditos sólo si vuelven con dato: un bloque en null o con la lista vacía viaja igual y no se cobra. La misma consulta (mismos parámetros, campos y página) repetida dentro de los 5 minutos no se vuelve a cobrar y lleva el header x-consulta-repetida: true. Los créditos no vencen. Cada respuesta cobrable lleva x-creditos-cobrados (lo que costó), x-creditos-restantes y, si algún campo volvió vacío, x-campos-sin-cargo.

/empresa	1 crédito + campos adicionales
/busqueda	1 crédito por página
/busqueda-personas	1 crédito por página
/persona	1 crédito
/llamados	1 crédito por página
/importadores	1 crédito por página
/serie	gratiscupo 1.000/día
/inflacion	gratiscupo 1.000/día
/convertir	gratiscupo 1.000/día
/series	gratiscupo 1.000/día
/sugerencias	gratiscupo 1.000/día
/creditos	gratis
/empresa?campos=empleados	+1 créditos
/empresa?campos=geo	+1 créditos
/empresa?campos=beneficiarios	+2 créditos
/empresa?campos=estados_contables	+2 créditos
/empresa?campos=situacion_historica	+1 créditos
/empresa?campos=paritarias	+1 créditos
/empresa?campos=score	+5 créditos
/empresa?campos=balances_cnv	+1 créditos
/empresa?campos=registros	+1 créditos

/busqueda: 10 filas por página con los créditos gratis, 50 con packs o plan pago.

Límites y paginación

Rate limit: 60 requests por minuto por API key (120 por IP). Pasado, 429.

Paginación: los listados usan el parámetro pagina (arranca en 1) con una profundidad máxima por endpoint: 400 páginas en /busqueda, 50 páginas en /busqueda-personas, 500 páginas en /llamados, 250 páginas en /importadores. Fuera de rango se ajusta al máximo, sin error. El total siempre es el real: para llegar a cualquier registro, acotá con filtros. Filas por página: 20 en /busqueda-personas, 20 en /llamados, 20 en /importadores.

Volumen, límites propios o contrato: [email protected].

Errores

JSON con error en snake_case y contexto cuando aplica (campo, ayuda). Nunca se cobran.

400	Parámetro inválido: cuit_invalido, q_invalido, campo_invalido (con el campo), jurisdiccion_invalida, actividad_invalida, forma_legal_invalida, estado_fiscal_invalido, capital_invalido, rubro_invalido u organismo_invalido (con lo que llegó y los valores válidos)
401	api_key_faltante (no llegó el header), api_key_malformada (la key llegó cortada o con otro formato: dice qué llegó) o api_key_invalida (el formato está bien pero la key no existe o fue revocada)
402	creditos_insuficientes
404	Empresa o persona no encontrada (el CUIT no existe o no tiene actividad; una empresa que sólo está en el padrón fiscal responde 200 con alcance padron, y /empresa con el CUIT de una persona responde su ficha de persona), o endpoint inexistente
429	limite_de_requests_excedido (60/min por key), limite_diario_gratuito_excedido (cupo diario de los endpoints gratis) o limite_diario_autoservicio_excedido (5.000 créditos por cuenta y por día en autoservicio; trae cupo_diario)
500	error_interno: falla nuestra. Reintentar; no se cobra
503	servicio_no_disponible (problema 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 en segundos; no se cobra

Endpoints

Todos los endpoints son GET sobre https://indicadores.ar/v1. Cada uno documenta sus parámetros, su costo y la lista completa de campos de respuesta.

Ficha de empresa

1 crédito + campos adicionales

GET/v1/empresa

Identidad registral y fiscal, dirigentes y socios con su participación, vínculos con otras empresas, los 15 tipos de acto societario con el link al aviso oficial, situación BCRA banco por banco, cheques rechazados, comercio exterior, contratos con el Estado y sanciones. Con campos= se suman bloques que cuestan créditos extra. Una empresa que sólo está en el padrón fiscal responde igual con alcance: padron; el 404 es para el CUIT que no existe. Si el CUIT es de una persona (empieza con 20, 23, 24, 25, 26 o 27), la respuesta es su ficha de persona con ficha: persona, cobrada como /persona y sin los campos adicionales.

Parámetros

cuitstringrequerido

CUIT de la empresa (11 dígitos, con o sin guiones).

Ejemplo: 30500010912

camposstringopcional

Campos adicionales a incluir, separados por coma. Cada uno suma su costo en créditos al de la ficha. Disponibles: empleados (+1), geo (+1), beneficiarios (+2), estados_contables (+2), situacion_historica (+1), paritarias (+1), score (+5), balances_cnv (+1), registros (+1).

Ver los 9 valores posibles

empleadosgeobeneficiariosestados_contablessituacion_historicaparitariasscorebalances_cnvregistros

Ejemplo: beneficiarios

Campos adicionales

campos=empleados+1 créditos

Dotación conocida. La cantidad de empleados que el Estado publicó para esta sociedad, como banda con fuente y fecha más la serie completa: salario complementario del ATP por ronda (2020), créditos ATP, REPRO II por mes (nov-2020 a abr-2022) e inspecciones laborales. Es un dato histórico, no la dotación actual (la nómina exacta por CUIT está bajo secreto fiscal). Sólo para sociedades; en una persona física viaja null. Null también cuando no hay ningún conteo publicado. En null no se cobra.

campos=geo+1 créditos

Geolocalización del domicilio. Latitud y longitud del domicilio legal, resueltas contra el normalizador geográfico del IGN (Georef) y verificadas calle por calle: sólo se entrega la coordenada cuya calle coincide con la del padrón. `precision` dice si el punto es la puerta o el centro de la cuadra. Cuando el domicilio no se pudo resolver el bloque viaja en null y no se cobra.

campos=beneficiarios+2 créditos

Beneficiarios finales estimados. Cadena de propiedad calculada on-demand: socios/accionistas humanos directos y a través de sociedades intermedias, multiplicando las participaciones publicadas en los actos societarios (profundidad máxima 3 niveles, umbral de referencia 10%). Es una estimación por actos registrales publicados: el registro de beneficiarios finales de ARCA no es público.

campos=estados_contables+2 créditos

Estados contables publicados. Serie de activo, pasivo, patrimonio neto y resultado acumulado del ejercicio, tal como la empresa los presenta ante su regulador. Sólo existe para los universos que están obligados a publicarlos: bancos y entidades financieras ante el BCRA (mensual, desde 1996) y aseguradoras ante la Superintendencia de Seguros (trimestral, desde 2008). El balance de una sociedad común no es público en Argentina. ⚠️ El resultado es ACUMULADO del ejercicio y cada régimen cierra en un mes distinto: el de los bancos es el año calendario y el de las aseguradoras arranca el 1 de julio, así que cada período informa cuántos meses acumula.

campos=situacion_historica+1 créditos

Situación crediticia histórica. Serie mensual de la situación en la central de deudores del BCRA: deuda total, situación principal, peor situación y cantidad de entidades informantes por período. El bloque deudas_bcra de la ficha trae la última foto; esto es la película, que es lo que responde si la empresa mejora o empeora. La serie se acumula desde mayo-2024 (el BCRA publica una ventana móvil de ~24 meses y esta serie conserva lo que la ventana va dejando atrás).

campos=paritarias+1 créditos

Convenios y paritarias homologados. Índice de los actos de la autoridad laboral nacional que homologan, registran o fijan topes sobre acuerdos de esta empresa: tipo de acto, número, fecha, sindicato firmante, número de CCT y expediente. ⚠️ Es el ÍNDICE, no las escalas: el acto remite al anexo para la vigencia y los montos, y ese anexo se referencia en `anexos`. Una vigencia con fechas propias aparece en el 0,3% de los avisos.

campos=score+5 créditos

Score de riesgo. El score de riesgo de la empresa (0 a 100) con su nivel, cuántas dimensiones se pudieron evaluar y el desglose de QUÉ lo sube y QUÉ lo baja, con el hecho de registro público que produjo cada renglón. Es un resumen de hechos publicados convertido en un número con criterio explícito: no es una calificación crediticia ni una probabilidad de incumplimiento, sólo existe para empresas y no usa ninguna variable demográfica. Arranca en 70 (consultado y sin observaciones), las observaciones restan hasta 0 y las señales positivas suman hasta 100 y nunca restan; la prescripción de la central de deudores y de los cheques rechazados es parte del cálculo. ⚠️ El desglose dice qué pesa y en qué sentido, no cuántos puntos: los pesos no se publican. Se calcula en el momento con los mismos datos que la ficha.

campos=balances_cnv+1 créditos

Balances presentados ante la CNV. Índice de los estados contables que una emisora presentó ante la Comisión Nacional de Valores: fecha de cierre, tipo (individual o consolidado), periodicidad y norma contable. ⚠️ Es el ÍNDICE, no los importes, que van en el documento de cada presentación. Complementa a `estados_contables`, que sí trae importes pero sólo para bancos (BCRA) y aseguradoras (SSN). Las presentaciones de controladas y vinculadas informan el balance de OTRA sociedad y no entran en la lista: se cuentan aparte.

campos=registros+1 créditos

Licencias y registros oficiales. Los padrones oficiales en los que figura la empresa, con el organismo y el estado: emisora en la CNV, entidad financiera (BCRA) o aseguradora (SSN) que presenta balances, establecimientos habilitados para exportar a la Unión Europea, matrícula de cooperativa o mutual en el INAES, establecimientos habilitados por el SENASA (frigoríficos, elaboradores, depósitos de frío, pesqueros y avícolas) y habilitaciones comerciales otorgadas por la AGC de la Ciudad desde 2015, con matrícula o número, fechas, domicilio y rubros. ⚠️ Una habilitación de la AGC es un trámite APROBADO, no una constancia de que el local sigue abierto. Si la empresa no figura en ninguno, el bloque viaja vacío.

Request

curl "https://indicadores.ar/v1/empresa?cuit=30500010912&campos=empleados,geo,beneficiarios" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "ficha": "empresa",
  "ficha_nota": null,
  "cuit": "30712345678",
  "alcance": "registro",
  "alcance_nota": null,
  "razon_social": "MOLINOS DEL SUR S.A.",
  "denominaciones_anteriores": [
    { "nombre": "MOLINOS BAHIENSES S.A.", "hasta": "2019-06-12", "fuente": "boletin_oficial" }
  ],
  "forma_legal": "sa",
  "jurisdiccion": "Buenos Aires",
  "ciudad": "Bahía Blanca",
  "domicilio_legal": "BRANDSEN 2350 BAHIA BLANCA",
  "domicilio_fiscal": "BRANDSEN 2350, BAHIA BLANCA, BUENOS AIRES",
  "contacto": {
    "sitios_web": [ { "url": "https://molinosdelsur.com.ar", "origen": "registro" } ],
    "email": "[email protected]",
    "telefono": "+54 291 455-1200",
    "verificado_el": "2026-08-30"
  },
  "fecha_constitucion": "2004-03-11",
  "actividad": { "codigo": "106110", "nombre": "Molienda de trigo" },
  "actividades": [
    { "codigo": "106110", "descripcion": "MOLIENDA DE TRIGO", "orden": 1, "principal": true, "desde": "2013-11", "estado": "activa", "baja_detectada_el": null },
    { "codigo": "463121", "descripcion": "VENTA AL POR MAYOR DE CEREALES (INCLUYE ARROZ), OLEAGINOSAS Y FORRAJERAS EXCEPTO SEMILLAS", "orden": 2, "principal": false, "desde": "2016-04", "estado": "activa", "baja_detectada_el": null },
    { "codigo": "492229", "descripcion": "SERVICIO DE TRANSPORTE AUTOMOTOR DE CARGAS N.C.P.", "orden": 3, "principal": false, "desde": "2013-11", "estado": "baja", "baja_detectada_el": "2026-08-20" }
  ],
  "actividades_al": "2026-09-28",
  "estado_fiscal": "activa",
  "fiscal": { "iva": "AC", "ganancias": "AC", "padron_al": "2026-09-12" },
  "perfil": { "importador": true, "exportador": true, "empleador": true, "empleador_fuente": "arca_padron", "empleador_al": "2026-09-12" },
  "capital": { "fecha_ultimo_balance": "2025-12-31", "capital_ultimo_balance": "125000000.00" },
  "dirigentes": [
    { "cuit": "20214567890", "nombre_completo": "PEREZ, JUAN CARLOS", "roles": ["presidente", "socio"], "cargos": [{ "rol": "presidente", "desde": "2026-04-10", "hasta": null }, { "rol": "socio", "desde": "2004-03-11", "hasta": null }], "vigente": true, "funcionario_publico": false, "participacion_pct": 60, "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1500001/20260415" },
    { "cuit": "27258901234", "nombre_completo": "GOMEZ, MARIA LAURA", "roles": ["vicepresidente", "socio"], "cargos": [{ "rol": "vicepresidente", "desde": "2026-04-10", "hasta": null }, { "rol": "socio", "desde": "2025-06-12", "hasta": null }], "vigente": true, "funcionario_publico": false, "participacion_pct": 40, "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1500001/20260415" },
    { "cuit": "20301234567", "nombre_completo": "LOPEZ, DIEGO MARTIN", "roles": ["director suplente"], "cargos": [{ "rol": "director suplente", "desde": "2026-04-10", "hasta": null }], "vigente": true, "funcionario_publico": true, "participacion_pct": null, "aviso_url": null },
    { "cuit": "20187654321", "nombre_completo": "RUIZ, ALBERTO", "roles": ["sindico"], "cargos": [{ "rol": "sindico", "desde": "2021-05-03", "hasta": "2026-04-10" }], "vigente": false, "funcionario_publico": false, "participacion_pct": null, "aviso_url": null }
  ],
  "dirigentes_total": 4,
  "directorio_vigente": {
    "fecha": "2026-04-15",
    "personas": [
      { "cuit": "20214567890", "nombre_completo": "PEREZ, JUAN CARLOS", "rol": "presidente" },
      { "cuit": "27258901234", "nombre_completo": "GOMEZ, MARIA LAURA", "rol": "vicepresidente" },
      { "cuit": "20301234567", "nombre_completo": "LOPEZ, DIEGO MARTIN", "rol": "director suplente" }
    ]
  },
  "vinculos_societarios": [
    { "tipo": "controlante", "direccion": "esta_empresa_es_sujeto", "denominacion": "HARINAS PATAGONICAS S.R.L.", "cuit": "30709876543", "participacion_pct": 95, "fecha": "2025-11-03" },
    { "tipo": "fusion_absorbente", "direccion": "esta_empresa_es_contraparte", "denominacion": "AGRO SUR S.A.", "cuit": "30655544332", "participacion_pct": null, "fecha": "2019-07-22" }
  ],
  "cobertura_societaria": { "jurisdiccion": "Buenos Aires", "desde": "2009-01-05", "nota": "El historial societario sale del archivo digitalizado del boletín oficial de la jurisdicción de registro, que llega hasta el 2009-01-05…" },
  "eventos": [
    { "tipo": "cambio_autoridades", "fecha": "2026-04-15", "titulo": "Designación de directorio", "descripcion": "Por asamblea del 10/04/2026 se designó presidente a Juan Carlos Pérez…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1500001/20260415", "datos": { "fecha_asamblea": "2026-04-10" } },
    { "tipo": "asamblea", "fecha": "2026-03-20", "titulo": "Convocatoria a asamblea general ordinaria", "descripcion": "Se convoca a los accionistas a la asamblea del 10/04/2026 a las 11 hs…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1490002/20260320", "datos": { "fecha_asamblea": "2026-04-10", "hora_asamblea": "11:00", "lugar_asamblea": "Brandsen 2350, Bahía Blanca", "orden_del_dia": "1) Designación de dos accionistas para firmar el acta. 2) Consideración de la memoria y balance…" } },
    { "tipo": "aumento_capital", "fecha": "2025-11-03", "titulo": "Aumento de capital", "descripcion": "Se resolvió aumentar el capital de $ 80.000.000 a $ 125.000.000…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1470003/20251103", "datos": { "capital_nuevo": "125000000" } },
    { "tipo": "cesion_participaciones", "fecha": "2025-06-12", "titulo": "Cesión de acciones", "descripcion": "Roberto Pérez cede el 10% del capital a María Laura Gómez…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1450004/20250612", "datos": { "cedente": "PEREZ, ROBERTO" } },
    { "tipo": "cambio_domicilio", "fecha": "2024-09-02", "titulo": "Cambio de sede social", "descripcion": "Se traslada la sede a Brandsen 2350, Bahía Blanca…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1400005/20240902" },
    { "tipo": "cambio_objeto", "fecha": "2023-05-18", "titulo": "Reforma del objeto social", "descripcion": "Se amplía el objeto a la elaboración de pastas secas…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1300006/20230518", "datos": { "objeto_nuevo": "Molienda de trigo y elaboración de pastas secas" } },
    { "tipo": "cambio_denominacion", "fecha": "2022-02-07", "titulo": "Cambio de denominación", "descripcion": "MOLINO PEREZ S.A. pasa a denominarse MOLINOS DEL SUR S.A.…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1200007/20220207", "datos": { "denominacion_anterior": "MOLINO PEREZ S.A." } },
    { "tipo": "modificacion", "fecha": "2021-08-30", "titulo": "Reforma de estatuto", "descripcion": "Se reforman los artículos 4 y 9 del estatuto…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1100008/20210830", "datos": { "duracion": "99 años" } },
    { "tipo": "fusion", "fecha": "2019-07-22", "titulo": "Fusión por absorción", "descripcion": "MOLINO PEREZ S.A. absorbe a AGRO SUR S.A.…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A900009/20190722", "datos": { "sociedad_absorbente": "MOLINO PEREZ S.A.", "sociedad_absorbida": "AGRO SUR S.A." } },
    { "tipo": "escision", "fecha": "2017-11-14", "titulo": "Escisión", "descripcion": "Se escinde parte del patrimonio para constituir LOGISTICA DEL SUR S.R.L.…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A800010/20171114", "datos": { "sociedad_escindida": "LOGISTICA DEL SUR S.R.L.", "patrimonio_escindido": "12000000" } },
    { "tipo": "transferencia_fondo_comercio", "fecha": "2016-03-01", "titulo": "Transferencia de fondo de comercio", "descripcion": "Transfiere el fondo de comercio del local de Punta Alta a…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A700011/20160301", "datos": { "ubicacion_fondo": "Punta Alta" } },
    { "tipo": "concurso", "fecha": "2012-06-05", "titulo": "Apertura de concurso preventivo", "descripcion": "El Juzgado Civil y Comercial N° 2 de Bahía Blanca declaró abierto el concurso preventivo…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A500012/20120605", "datos": { "juzgado": "Juzgado Civil y Comercial N° 2 de Bahía Blanca", "sindico": "Estudio Fernández y Asoc.", "fecha_verificacion": "2012-08-20", "fecha_informe_general": "2012-11-15", "expediente": "45.678/2012" } },
    { "tipo": "quiebra", "fecha": "2009-04-17", "titulo": "Quiebra (antecedente del fondo transferido)", "descripcion": "Se decreta la quiebra de la sociedad titular anterior del fondo de comercio…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A300013/20090417", "datos": { "juzgado": "Juzgado Comercial N° 12", "sindico": "Contador Público Aldo Martínez", "fallido": "PANIFICADORA ATLANTICA S.R.L." } },
    { "tipo": "disolucion", "fecha": "2009-02-10", "titulo": "Disolución y liquidación (sociedad antecesora)", "descripcion": "Se resuelve la disolución anticipada y se designa liquidador…", "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A300014/20090210", "datos": { "liquidador": "PEREZ, JUAN CARLOS", "domicilio_liquidador": "Brandsen 2350, Bahía Blanca" } },
    { "tipo": "constitucion", "fecha": "2004-03-11", "titulo": "Constitución de sociedad", "descripcion": "Constitución de MOLINO PEREZ S.A. Capital $ 12.000…", "aviso_url": null, "datos": { "tipo_societario": "S.A.", "duracion": "99 años", "valor_nominal": "1" } }
  ],
  "bcra_consultado_el": "2026-09-10T03:12:00.000Z",
  "deudas_bcra": {
    "periodo": "202608",
    "peor_situacion": 2,
    "situacion_principal": 1,
    "situacion_principal_label": "Normal",
    "deuda_total_miles": 412500,
    "entidades": 3,
    "entidades_detalle": [
      { "entidad": "BANCO DE LA NACION ARGENTINA", "situacion": 1, "situacion_label": "Normal", "deuda_miles": 310000, "dias_atraso": 0, "refinanciado": false, "en_juicio": false },
      { "entidad": "BANCO DE GALICIA Y BUENOS AIRES S.A.", "situacion": 1, "situacion_label": "Normal", "deuda_miles": 95000, "dias_atraso": 0, "refinanciado": false, "en_juicio": false },
      { "entidad": "TARJETA NARANJA S.A.", "situacion": 2, "situacion_label": "Con seguimiento especial", "deuda_miles": 7500, "dias_atraso": 45, "refinanciado": true, "en_juicio": false }
    ]
  },
  "cheques_rechazados": {
    "total": 2,
    "impagos": 0,
    "detalle": [
      { "numero": "00012345", "entidad": "BANCO DE GALICIA Y BUENOS AIRES S.A.", "fecha": "2025-02-14", "monto": "850000.00", "causal": "SIN FONDOS", "pagado": true, "fecha_pago": "2025-02-20" },
      { "numero": "00012399", "entidad": "BANCO DE GALICIA Y BUENOS AIRES S.A.", "fecha": "2024-11-03", "monto": "120000.00", "causal": "DEFECTO FORMAL", "pagado": true, "fecha_pago": "2024-11-05" }
    ]
  },
  "comercio_exterior": {
    "importaciones": {
      "periodo_desde": "202509", "periodo_hasta": "202608", "fob_usd": 1840000, "items": 57, "despachos": 42, "kilos": 310000,
      "cif": { "cif_usd_estimado": 1902000, "flete_y_seguro_usd_estimado": 62000, "flete_sobre_fob_pct": 3.37, "cobertura_fob_pct": 100, "fob_imputado_usd": 0 },
      "tributos": { "derechos_usd": 51000, "tributos_totales_usd": 690000 },
      "principales_ncm": [ { "ncm": "8437.80.00", "descripcion": "Máquinas para molienda", "fob_usd": 900000, "items": 6 } ],
      "principales_origenes": [ { "pais": "203", "pais_nombre": "Brasil", "pais_iso": "BR", "fob_usd": 1200000, "items": 31 }, { "pais": "310", "pais_nombre": "China", "pais_iso": "CN", "fob_usd": 640000, "items": 26 } ],
      "principales_procedencias": [ { "pais": "203", "pais_nombre": "Brasil", "pais_iso": "BR", "fob_usd": 1200000, "items": 31 } ],
      "vias_de_transporte": [ { "codigo": "4", "descripcion": "Carretero", "fob_usd": 1200000, "items": 31 } ],
      "aduanas": [ { "codigo": "001", "descripcion": "BUENOS AIRES", "fob_usd": 640000, "items": 26 } ],
      "regimenes": [ { "codigo": "IC", "descripcion": "A consumo", "fob_usd": 1840000, "items": 57 } ],
      "serie_mensual": [ { "periodo": "202608", "fob_usd": 210000, "items": 7 } ]
    },
    "exportaciones_granos": {
      "periodo_desde": "202509", "periodo_hasta": "202608", "toneladas": 18500, "declaraciones": 12,
      "principales_productos": [ { "producto": "HARINA DE TRIGO", "toneladas": 18500, "declaraciones": 12 } ],
      "serie_mensual": [ { "periodo": "202608", "toneladas": 1500 } ]
    },
    "exportaciones_energia": null,
    "habilitaciones_ue": null
  },
  "contratos_publicos": {
    "cantidad": 3,
    "total_ars": 48200000,
    "recientes": [
      { "organismo": "Ministerio de Desarrollo Social", "fecha": "2026-05-06", "monto": "18500000.00", "moneda": "ARS", "descripcion": "Adquisición de harina 000 para comedores escolares", "rol": "adjudicataria" },
      { "organismo": "Municipalidad de Bahía Blanca", "fecha": "2025-10-19", "monto": "6200000.00", "moneda": "ARS", "descripcion": "Provisión de alimentos secos", "rol": "oferente" }
    ]
  },
  "creditos_subsidiados": { "cantidad": 1 },
  "sanciones": [ { "fecha": "2018-06-21", "titulo": "Multa de la Secretaría de Comercio por incumplimiento de la Ley de Lealtad Comercial" } ],
  "apoc": null,
  "sanciones_laborales_repsal": [
    { "tipo_infraccion": "Trabajo no registrado", "organismo_sancionador": "Ministerio de Trabajo de la Provincia de Buenos Aires", "fecha_ingreso": "2025-03-03", "fin_publicacion": "2026-03-03", "numero_expediente": "EX-2024-11223344-GDEBA" }
  ],
  "empleados": { "cantidad": 180, "banda": "51-200", "fuente": "repro2", "al": "2022-04-01", "serie": [ { "periodo": "2022-04", "cantidad": 180, "fuente": "repro2" }, { "periodo": "2020-12", "cantidad": 164, "fuente": "atp_salario" } ] },
  "geo": { "lat": -38.7183, "lon": -62.2663, "precision": "puerta", "radio_m": null, "domicilio": "legal", "fuente": "georef", "nomenclatura": "BRANDSEN 2350, Bahía Blanca, Buenos Aires", "provincia_id": "06", "departamento_id": "06056", "localidad_id": "06056010", "cpa": null, "al": "2026-09-01" },
  "beneficiarios": {
    "umbral_pct": 10,
    "profundidad_maxima": 3,
    "metodologia": "Estimación a partir de los actos societarios publicados…",
    "personas": [
      { "cuit": "20214567890", "nombre_completo": "PEREZ, JUAN CARLOS", "participacion_directa_pct": 60, "participacion_efectiva_pct": 60, "es_beneficiario_estimado": true, "cadena": [] },
      { "cuit": "27258901234", "nombre_completo": "GOMEZ, MARIA LAURA", "participacion_directa_pct": 40, "participacion_efectiva_pct": 40, "es_beneficiario_estimado": true, "cadena": [] }
    ]
  },
  "consultado_el": "2026-09-11T14:00:00.000Z"
}

Campos de la respuesta (349)

Campo	Tipo	Descripción
`ficha`	string	Qué ficha es la respuesta. empresa salvo cuando el CUIT es de una persona: ahí la respuesta es la ficha de persona (la misma de /v1/persona), cobrada como tal. empresa \| persona
`ficha_nota`	string \| null	Explica por qué la ficha no es la del endpoint pedido. Null cuando lo es.
`cuit`	string
`alcance`	string	registro = la empresa está en el padrón societario (publicó actos o la inscribió un registro) y la ficha es completa. padron = sólo figura en el padrón fiscal: la ficha trae identidad, actividad, estado, domicilio fiscal y fecha de contrato, más los bloques que se indexan por CUIT (situación crediticia, cheques, comercio exterior, contratos públicos, sanciones); autoridades, vínculos y actos vienen vacíos porque no hay archivo del que sacarlos. Es el caso de sociedades de hecho, unipersonales y productores que nunca publicaron un acto. Cuesta lo mismo. registro \| padron
`alcance_nota`	string \| null	Explica el alcance cuando es padron; null en una ficha completa.
`razon_social`	string
`denominaciones_anteriores`	array	Cómo se llamó antes la sociedad, la más reciente primero. La llave para cruzar fuentes que no traen CUIT (contratos, facturas, padrones viejos): el nombre caduca y el CUIT no. No incluye correcciones de tipeo, razones sociales truncadas que después se completaron ni cambios de forma ("S.A." por "SA"). Vacío si no se le conoce otro nombre, y siempre vacío para una persona física.
`nombre`	string
`hasta`	date \| null	Hasta cuándo se llamó así: la fecha de publicación del cambio. Null cuando el cambio se conoció por el padrón y no por un aviso.
`fuente`	string \| null	De dónde sale el cambio. boletin_oficial \| arca \| registro_societario
`forma_legal`	string \| null
`jurisdiccion`	string \| null
`ciudad`	string \| null
`domicilio_legal`	string \| null	Domicilio registrado ante el registro societario (puede estar desactualizado).
`domicilio_fiscal`	string \| null	Domicilio fiscal declarado ante ARCA.
`contacto`	object \| null	Sitio web, mail y teléfono de la empresa. Null cuando no se le conoce ningún sitio que responda, o cuando el CUIT es el de un hosting que registra dominios de terceros (en ese caso no se puede saber cuál es el propio).
`sitios_web`	array	Sitios web de la empresa que RESPONDEN, los de origen registral primero. Un dominio que no contesta, o que todavía no verificamos, no se devuelve: el registro de dominios tiene muchas altas que nunca se usaron y devolverlas sería mandarte a un link roto. Se devuelven todos los que quedan y no uno solo: el 39% de las empresas con sitio tiene más de uno y elegir el principal sería una corazonada.
`url`	string
`origen`	string	registro = el CUIT figura como titular del dominio en NIC Argentina, es un hecho. inferido = se dedujo de la razón social y se verificó bajando la página, que sólo se acepta si publica el CUIT, o si el nombre no tiene homónimos en el padrón y el sitio se declara argentino. registro \| inferido
`email`	string \| null	Mail publicado por la empresa en el primero de sus sitios que se pudo leer. Cobertura todavía baja: el dominio se conoce para muchas más empresas que el mail.
`telefono`	string \| null	Teléfono publicado por la empresa en su propio sitio.
`verificado_el`	date \| null	Fecha en que se leyó el sitio del que salieron mail y teléfono. Null cuando todavía sólo se conoce el dominio.
`fecha_constitucion`	date \| null
`actividad`	object
`codigo`	string \| null	Código de actividad AFIP.
`nombre`	string \| null
`actividades`	array	TODAS las actividades declaradas ante ARCA según la constancia de inscripción: primero las vigentes por su orden (la primera es la principal) y después las dadas de baja. Sin costo extra. Vacío cuando la constancia todavía no se leyó para este CUIT (ver actividades_al), y siempre vacío para un CUIT de persona física.
`codigo`	string	Código CLAE de ARCA sin ceros adelante, el mismo formato que actividad.codigo.
`descripcion`	string \| null
`orden`	integer	Orden en la constancia: 1 es la principal.
`principal`	boolean
`desde`	string \| null	Mes de alta de la actividad (AAAA-MM), tal como lo informa ARCA.
`estado`	string	baja = estaba declarada en una lectura anterior de la constancia y dejó de figurar. activa \| baja
`baja_detectada_el`	date \| null	Fecha de la lectura en la que dejó de figurar: la baja ocurrió ese día o antes.
`actividades_al`	date \| null	Fecha de la última constancia de inscripción leída para este CUIT. Null si nunca se leyó.
`estado_fiscal`	string
`perfil`	object
`importador`	boolean
`exportador`	boolean
`empleador`	boolean \| null	true = inscripta como empleadora ante el fisco (aportes y contribuciones de seguridad social). false = el padrón masivo de ARCA o la constancia de inscripción la traen como no inscripta. null = sin dato (el padrón la publica en blanco, o todavía no se verificó): su ausencia no afirma que no tenga empleados. Siempre viene con empleador_fuente y empleador_al.
`empleador_fuente`	string \| null	De dónde salió empleador: arca_padron (padrón masivo de ARCA, corte mensual), constancia (constancia de inscripción leída en vivo) o repsal (dotación relevada en una inspección laboral). Gana la fuente más nueva. arca_padron \| constancia \| repsal
`empleador_al`	date \| null	Fecha del corte al que corresponde empleador (la del padrón o la de la lectura).
`fiscal`	object \| null	Condición ante ARCA según el padrón masivo (corte mensual): IVA y ganancias con la fecha del corte. Null cuando el padrón no informa ninguno de los dos (en blanco no es 'no').
`iva`	string \| null	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. AC \| EX \| NI \| NA \| XN \| AN
`ganancias`	string \| null	Código de ARCA: AC inscripto, EX exento, NI no inscripto, NC no corresponde. Null = en blanco. AC \| EX \| NI \| NC
`padron_al`	date	Fecha del corte del padrón masivo de ARCA.
`capital`	object
`fecha_ultimo_balance`	date \| null
`capital_ultimo_balance`	string \| null
`dirigentes`	array	Personas vinculadas con documento: directores, socios, gerentes, síndicos, apoderados. Trae hasta 50, por nombre; dirigentes_total dice cuántas son. Una entrada por persona: si el registro la tiene partida en dos (el mismo DNI con dos CUIT, o el mismo nombre con un DNI mal tipeado), sale una sola con el CUIT que confirma el padrón de ARCA.
`cuit`	string
`nombre_completo`	string
`roles`	array<string>	Los cargos, sin fechas (lo mismo que cargos[].rol).
`cargos`	array	Un cargo por rol con su período. desde y hasta en null = figura en el registro societario sin fecha de designación ni de cese, lo que NO afirma que siga en el cargo.
`rol`	string
`desde`	date \| null	Fecha del acto que lo designó.
`hasta`	date \| null	Fecha del cese (renuncia o reemplazo).
`vigente`	boolean	Figura en directorio_vigente: lo designó el último acto y no renunció después.
`funcionario_publico`	boolean
`participacion_pct`	number \| null	% del capital suscripto según el aviso societario publicado.
`aviso_url`	string \| null	Link a un aviso del boletín oficial del que salió el vínculo, para leer la fuente y auditar el dato. Null cuando la fila viene de un padrón registral (sin aviso publicado) o cuando la fuente no ofrece una URL navegable por aviso.
`dirigentes_total`	integer	Cuántas personas vinculadas tiene la empresa. Mayor que el largo de dirigentes cuando la lista vino recortada. directorio_vigente se calcula sobre todas, no sólo sobre las listadas.
`directorio_vigente`	object	Las autoridades del ÚLTIMO acto de designación fechado, separadas del histórico acumulado de dirigentes. fecha: null con personas: [] significa que no se puede afirmar vigencia (ningún acto está fechado), no que la empresa no tenga autoridades.
`fecha`	date \| null	Fecha del acto de designación.
`personas`	array
`cuit`	string \| null
`nombre_completo`	string
`rol`	string
`vinculos_societarios`	array	Vínculos directos con otras empresas publicados en los boletines: socias/accionistas personas jurídicas, fusiones, escisiones y transferencias de fondo de comercio.
`tipo`	string	socia, ex_socia, absorbente, absorbida, beneficiaria_escision, escindente, cesionaria_fondo, cedente_fondo o vinculada.
`direccion`	string	esta_empresa_es_sujeto \| esta_empresa_es_contraparte
`denominacion`	string
`cuit`	string \| null
`participacion_pct`	number \| null
`fecha`	date
`cobertura_societaria`	object	Hasta dónde llega el archivo digitalizado del boletín de la jurisdicción de registro. Permite distinguir "no pasó nada" de "no hay archivo": el historial de eventos es completo dentro de esta cobertura, no antes de ella.
`jurisdiccion`	string \| null	Jurisdicción de registro de la empresa.
`desde`	date \| null	Primera edición digitalizada del canal societario de esa jurisdicción.
`nota`	string
`eventos`	array	Actos societarios (constitución, reformas, fusiones, disolución, quiebra, concurso). Historial completo, sin recortar: la profundidad depende del archivo de cada jurisdicción y la declara cobertura_societaria.
`tipo`	string
`fecha`	date
`titulo`	string \| null
`descripcion`	string \| null
`aviso_url`	string \| null	Link al aviso del boletín oficial que publicó el acto, para leer la fuente y replicar la lógica. Null cuando el evento viene de un padrón registral o la fuente no ofrece una URL navegable por aviso.
`datos`	object	Los datos que ESE acto publica y ningún otro tiene: el juzgado y el síndico de una quiebra, el liquidador de una disolución, el orden del día de una asamblea, el cedente de una cesión. Las claves varían según el tipo de acto y sólo aparecen las que el aviso publica; el objeto se omite cuando el acto no trae ninguna.
`bcra_consultado_el`	date-time \| null	Ú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 \| null	Situación en la central de deudores del BCRA. Null sin deuda informada (siempre que bcra_consultado_el no sea null).
`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`	array	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 \| null	Cheques rechazados informados por el BCRA. Null sin registros.
`total`	integer
`impagos`	integer
`detalle`	array	Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero).
`numero`	string
`entidad`	string
`fecha`	date
`monto`	string
`causal`	string \| null
`pagado`	boolean
`fecha_pago`	date \| null
`comercio_exterior`	object \| null	Bloque unificado de comercio exterior. Null si la empresa no registra operaciones.
`importaciones`	object \| null	Importaciones registradas, agregadas por mes, NCM, país, vía, aduana y régimen. El FOB es el declarado en dólares; el CIF y el flete son ESTIMADOS (objeto cif); los derechos y tributos sí son los efectivamente liquidados.
`periodo_desde`	string	Ventana AAAAMM de los totales y tops.
`periodo_hasta`	string
`fob_usd`	number
`items`	integer	Ítems de despacho de la ventana.
`despachos`	integer	Destinaciones distintas de la ventana.
`kilos`	number \| null	Peso neto, sólo de las operaciones cuya unidad estadística mide peso. Null cuando ninguna lo declara. NO es el peso total de lo importado.
`cif`	object \| null	Valor CIF y flete ESTIMADOS, despejados de la liquidación de tributos: la fuente aduanera publica FOB. Null cuando la estimación no cubre suficiente FOB del período.
`cif_usd_estimado`	number
`flete_y_seguro_usd_estimado`	number	Flete MÁS seguro; no se pueden separar.
`flete_sobre_fob_pct`	number	Incidencia sobre el FOB que tiene estimación, no sobre el total.
`cobertura_fob_pct`	number	Porcentaje del FOB del período con valor CIF estimado.
`fob_imputado_usd`	number	Parte del FOB cuyo CIF salió de una referencia externa y no de la propia operación.
`tributos`	object \| null	Tributos efectivamente liquidados. A diferencia del CIF, declarados.
`derechos_usd`	number
`tributos_totales_usd`	number
`principales_ncm`	array
`ncm`	string
`descripcion`	string \| null	Descripción oficial de la posición; degrada a la partida o al capítulo cuando el nomenclador no tiene esa apertura.
`fob_usd`	number
`items`	integer
`principales_origenes`	array
`pais`	string	Código de país de origen del nomenclador aduanero.
`pais_nombre`	string	Nombre del país de origen.
`pais_iso`	string \| null	ISO 3166-1 alpha-2. Null cuando la fuente no nombra un país vigente: zonas indeterminadas, "resto de", o entidades ya disueltas.
`fob_usd`	number
`items`	integer
`principales_procedencias`	array	País desde el que se despachó la mercadería, que difiere del de origen en un tercio de las operaciones.
`pais`	string
`pais_nombre`	string
`pais_iso`	string \| null	ISO 3166-1 alpha-2. Null cuando la fuente no nombra un país vigente: zonas indeterminadas, "resto de", o entidades ya disueltas.
`fob_usd`	number
`items`	integer
`vias_de_transporte`	array	Cómo llega la mercadería. Describe el último tramo hasta la aduana de registro.
`codigo`	string	Código tal como lo publica la fuente aduanera.
`descripcion`	string
`fob_usd`	number
`items`	integer
`aduanas`	array	Aduana de registro del despacho.
`codigo`	string	Código tal como lo publica la fuente aduanera.
`descripcion`	string
`fob_usd`	number
`items`	integer
`regimenes`	array	Régimen de la destinación (a consumo, courier, zona franca…).
`codigo`	string	Código tal como lo publica la fuente aduanera.
`descripcion`	string
`fob_usd`	number
`items`	integer
`serie_mensual`	array	Hasta 24 meses, del más viejo al más nuevo.
`periodo`	string
`fob_usd`	number
`items`	integer
`exportaciones_granos`	object \| null	Exportaciones declaradas de granos y subproductos, en toneladas por producto y mes.
`periodo_desde`	string
`periodo_hasta`	string
`toneladas`	number
`declaraciones`	integer
`principales_productos`	array
`producto`	string
`toneladas`	number
`declaraciones`	integer
`serie_mensual`	array	Hasta 24 meses, del más viejo al más nuevo.
`periodo`	string
`toneladas`	number
`exportaciones_energia`	object \| null	Exportaciones declaradas de petróleo, gas y derivados, en dólares por producto, destino y mes, más las ofertas de exportación de hidrocarburos registradas.
`periodo_desde`	string
`periodo_hasta`	string
`monto_usd`	number
`principales_productos`	array
`producto`	string
`monto_usd`	number
`principales_destinos`	array
`pais`	string
`pais_iso`	string \| null	ISO 3166-1 alpha-2. Null cuando la fuente no nombra un país vigente: zonas indeterminadas, "resto de", o entidades ya disueltas.
`monto_usd`	number
`serie_mensual`	array	Hasta 24 meses, del más viejo al más nuevo.
`periodo`	string
`monto_usd`	number
`ofertas_hidrocarburos`	object \| null
`total`	integer
`vigentes`	integer
`habilitaciones_ue`	object \| null	Habilitaciones sanitarias vigentes para exportar a la Unión Europea, por rubro.
`rubros`	array
`rubro`	string
`establecimientos`	integer
`contratos_publicos`	object
`cantidad`	integer	Cantidad de contrataciones con adjudicación confirmada.
`total_ars`	number
`recientes`	array
`organismo`	string \| null
`fecha`	date \| null
`monto`	string \| null
`moneda`	string \| null
`descripcion`	string \| null
`rol`	string \| null	adjudicataria \| oferente \| desestimada \| null = sin clasificar (participó del proceso).
`creditos_subsidiados`	object
`cantidad`	integer
`sanciones`	array	Sanciones administrativas publicadas (UIF/CNV/BCRA).
`fecha`	date
`titulo`	string \| null
`apoc`	object \| null	Presencia en la base APOC de ARCA (facturas apócrifas). Dato informativo/preventivo. Null si no figura.
`fecha_condicion`	date \| null
`fecha_publicacion`	date \| null
`sanciones_laborales_repsal`	array	Sanciones vigentes en el REPSAL (Registro Público de Empleadores con Sanciones Laborales).
`tipo_infraccion`	string
`organismo_sancionador`	string \| null
`fecha_ingreso`	date \| null
`fin_publicacion`	date \| null
`numero_expediente`	string
`empleados`campos=empleados · +1 créditos	object \| null	Dotación conocida de la sociedad, tal como la publicó el Estado. Sólo presente con campos=empleados. Es un dato HISTÓRICO (ATP 2020, REPRO II 2020-2022, inspección laboral): leerlo con su fuente y fecha, nunca como empleados actuales. Null cuando no hay ningún conteo publicado o el CUIT es de una persona física.
`cantidad`	integer	El conteo más reciente publicado.
`banda`	string	Banda del conteo más reciente, con los cortes del ATP. 1-5 \| 6-10 \| 11-50 \| 51-200 \| 200+
`fuente`	string \| null	atp_salario (perceptores del salario complementario, por ronda), atp_credito (empleados declarados en el crédito ATP), repro2 (trabajadores cubiertos por mes) o repsal (dotación relevada en una inspección). atp_salario \| atp_credito \| repro2 \| repsal
`al`	date \| null	Mes o fecha del conteo más reciente (primer día del período).
`serie`	array	Todos los conteos publicados, del más nuevo al más viejo.
`periodo`	string	Mes devengado (AAAA-MM).
`cantidad`	integer
`fuente`	string
`geo`campos=geo · +1 créditos	object \| null	Coordenadas del domicilio, resueltas contra el Georef del IGN y el normalizador de la Ciudad (USIG) y verificadas calle por calle. Sólo presente con campos=geo. Null cuando no hay ni siquiera una zona que dar o todavía no se intentó.
`lat`	number
`lon`	number
`precision`	string	puerta = calle y altura resueltas; calle = el punto es aproximado (la cara de manzana, el centro de la calle cuando el nomenclador no tiene alturas, el de varios puntos posibles para esa altura, o una esquina); zona = la calle no se pudo ubicar y el punto es el centro de la localidad o del código postal. radio_m dice el margen. puerta \| calle \| zona
`radio_m`	number \| null	Con precisión calle o zona, el margen en metros: la distancia del punto al lugar más lejano donde podría estar el domicilio (en una zona, el que cubre al 90% de sus empresas). Null con precisión puerta, o cuando no se conoce.
`domicilio`	string	De qué domicilio sale el punto: legal (el del registro) o fiscal (el de ARCA, que se usa cuando el legal no se puede ubicar y suele ser el actual). legal \| fiscal
`fuente`	string	georef (IGN, apis.datos.gob.ar), usig (normalizador de la Ciudad de Buenos Aires, CABA y conurbano), manzana (la cara de manzana de esa calle y altura, verificada contra la zona del código postal) o zona (el centro de las empresas ya ubicadas de esa localidad o código postal). georef \| usig \| manzana \| zona
`nomenclatura`	string \| null	Dirección normalizada tal como la devolvió el nomenclador, para auditar el match.
`provincia_id`	string \| null	Código INDEC de la provincia donde quedó el punto.
`departamento_id`	string \| null	Código INDEC del departamento o partido (comuna en CABA).
`localidad_id`	string \| null	Código INDEC de la localidad censal. Null cuando el nomenclador no la informa.
`cpa`	string \| null	Código Postal Argentino del domicilio (C1428AAO), tal como lo publica la Ciudad de Buenos Aires. Sólo en CABA y con precisión puerta; null en el resto del país.
`al`	date	Cuándo se resolvió.
`beneficiarios`campos=beneficiarios · +2 créditos	object	Beneficiarios finales ESTIMADOS por actos registrales publicados. Sólo presente con campos=beneficiarios.
`umbral_pct`	number	Umbral de referencia (10%, RG 4697 / UIF).
`profundidad_maxima`	integer
`metodologia`	string
`personas`	array
`cuit`	string
`nombre_completo`	string
`funcionario_publico`	boolean
`participacion_directa_pct`	number \| null	% directo cuando la persona es socia inmediata; null si sólo llega por cadena.
`participacion_efectiva_pct`	number \| null	Suma de los caminos cuantificables (directo + indirecto multiplicado).
`es_beneficiario_estimado`	boolean
`caminos_sin_porcentaje`	integer	Caminos societarios detectados cuyo % no fue publicado.
`cadena`	array	Sociedades intermedias del camino cuantificado de mayor peso (vacía = directa).
`cuit`	string
`razon_social`	string
`participacion_pct`	number \| null
`fecha_ultimo_acto`	date \| null
`estados_contables`campos=estados_contables · +2 créditos	object	Estados contables publicados ante el regulador. Sólo presente con campos=estados_contables. Si la empresa no pertenece a un universo obligado a publicarlos, el bloque viene con fuente null y periodos vacío.
`fuente`	string \| null	bcra \| ssn \| null.
`regulador`	string
`frecuencia`	string	mensual (BCRA) o trimestral (SSN).
`entidad`	string	Denominación con la que presenta ante el regulador.
`moneda`	string	Siempre ARS, en pesos corrientes del período.
`nota`	string
`periodos`	array	Del más nuevo al más viejo.
`periodo`	date	Primer día del período informado.
`activo`	number
`pasivo`	number
`patrimonio_neto`	number
`resultado`	number \| null	Acumulado del ejercicio.
`meses_de_ejercicio`	integer \| null	Cuántos meses acumula ese resultado. El ejercicio de los bancos es el año calendario y el de las aseguradoras arranca el 1 de julio, así que sin este campo el resultado de dos regímenes no es comparable.
`situacion_historica`campos=situacion_historica · +1 créditos	object	Serie mensual de la situación en la central de deudores del BCRA. Sólo presente con campos=situacion_historica. deudas_bcra trae la última foto; esto es la película, que es lo que responde si la empresa mejora o empeora. Sin historia acumulada el bloque viene con periodos vacío.
`periodos`	array	Del período más nuevo al más viejo.
`periodo`	string	Período informado (AAAAMM).
`deuda_total_miles`	number	Deuda total del período en miles de pesos.
`situacion_principal`	integer	Situación del grueso de la deuda del período. 1 = normal … 5 = irrecuperable.
`peor_situacion`	integer	La peor situación informada por alguna entidad en el período.
`entidades`	integer	Cantidad de entidades que informaron deuda en el período.
`nota`	string
`paritarias`campos=paritarias · +1 créditos	object	Índice de actos de la autoridad laboral nacional sobre acuerdos de esta empresa. Sólo presente con campos=paritarias. Si no hay ninguno, el bloque viene con total 0 y actos vacío. ⚠️ Es el índice, NO las escalas salariales: van en el anexo del acto.
`total`	integer
`desde`	date \| null	Publicación del acto más viejo.
`nota`	string
`actos`	array	Del más nuevo al más viejo.
`fecha_publicacion`	date
`tipo`	string	homologacion \| registro \| tope_indemnizatorio \| otro.
`acto`	string \| null	Tipo, número y año del acto.
`fecha_del_acto`	date \| null
`autoridad`	string \| null
`expediente`	string \| null
`numero_de_acuerdo`	string \| null
`cct`	array	Números de convenio colectivo alcanzados.
`sindicatos`	array	Entidades gremiales firmantes.
`tiene_anexo`	boolean
`anexos`	array	Referencias al anexo del acto, donde están las escalas y la vigencia.
`balances_cnv`campos=balances_cnv · +1 créditos	object	Índice de estados contables presentados ante la Comisión Nacional de Valores. Sólo presente con campos=balances_cnv. ⚠️ Es el índice, NO los importes: van en el documento de cada presentación. Complementa a estados_contables, que sí trae importes pero sólo para bancos y aseguradoras.
`total`	integer	Presentaciones PROPIAS de la emisora.
`desde`	date \| null	Cierre de la presentación más vieja.
`presentaciones_de_vinculadas`	integer	Presentaciones en las que la emisora informa el balance de una controlada o vinculada. No son balances suyos y por eso no entran en la lista.
`nota`	string
`presentaciones`	array	De la más nueva a la más vieja.
`fecha_cierre`	date \| null
`fecha_presentacion`	date
`tipo_balance`	string \| null	INDIVIDUAL \| CONSOLIDADO.
`periodicidad`	string \| null
`norma_contable`	string \| null
`registros`campos=registros · +1 créditos	object	Licencias y registros oficiales de la empresa. Sólo presente con campos=registros; vacío (total 0, listas vacías) si no figura en ninguno.
`total`	integer	Inscripciones en INAES, SENASA y AGC, aunque la lista traiga menos (tope 200).
`resumen`	array	Un renglón por registro: qué organismo, qué registro, en qué estado y cuántas inscripciones resume. Incluye CNV, BCRA, SSN y Unión Europea, que tienen su propio detalle en otros bloques.
`organismo`	string	CNV \| BCRA \| SSN \| UE \| INAES \| SENASA \| AGC
`organismo_nombre`	string
`registro`	string	Cooperativa, Elaborador, Habilitación comercial, …
`estado`	string \| null	Tal como lo publica el organismo.
`cantidad`	integer	Establecimientos o habilitaciones que resume.
`inscripciones`	array	El detalle de cada inscripción en INAES, SENASA y AGC: vigentes primero, después las de baja; dentro de cada una, la más nueva primero.
`organismo`	string	INAES \| SENASA \| AGC
`registro`	string
`numero`	string \| null	Matrícula (INAES), número oficial (SENASA) o número de solicitud (AGC).
`estado`	string \| null	INAES: Vigente, Suspendida, Cancelada, Retiro de autorización, Autorización revocada, En disolución y liquidación. SENASA: Habilitado. AGC: Otorgada.
`estado_visto_desde`	date \| null	Desde cuándo vemos el estado actual. El organismo no publica la fecha del cambio: es la primera vez que nuestra copia lo encontró así.
`fecha`	date \| null	Fecha de inscripción (INAES) o de la habilitación (AGC). El SENASA no la publica.
`domicilio`	string \| null
`localidad`	string \| null
`provincia`	string \| null
`actividades`	array	Actividades (INAES, SENASA) o rubros (AGC).
`establecimiento`	string \| null	Nombre del establecimiento (SENASA).
`superficie_m2`	number \| null	Superficie habilitada (AGC).
`expediente`	string \| null	Expediente de la habilitación (AGC).
`nota`	string \| null	Lo que el padrón anota junto al nombre (INAES: "Bajo Sumario Res. 1659/16").
`nota`	string	El encuadre: qué cubre y qué no.
`score`campos=score · +5 créditos	object	Score de riesgo de la empresa. Sólo presente con campos=score. Resumen de hechos de registros públicos convertido en un número de 0 a 100 con criterio explícito; no es una calificación crediticia. Calculado en el momento con los mismos datos que la ficha.
`score`	integer	De 0 a 100. Arranca en 70 (consultado y sin observaciones): las observaciones restan, las señales positivas suman y nunca restan.
`nivel`	string	grave (menos de 40 con observaciones) · revisar (40 o más con observaciones) · sin_observaciones (se miró y no hay negativas) · sin_datos (nada evaluable). grave \| revisar \| sin_observaciones \| sin_datos
`nivel_label`	string	El nivel, legible.
`dimensiones_evaluadas`	integer	Cuántas dimensiones se pudieron mirar. "Sin observaciones" no es "sin datos": el número viaja siempre con esto.
`desglose`	array	Qué lo sube y qué lo baja, un renglón por señal encontrada. Sin los puntos: la fórmula no se publica.
`clave`	string	Identificador estable de la señal (quiebra, concurso, bcra_actual, bcra_historica, cheques_impagos, cheques_pagados, sanciones, repsal, apoc, fiscal, rotacion, patrimonio_neto, contratos, comex, antiguedad, balances, paritarias, empleadora, directorio, …).
`etiqueta`	string	La señal, legible.
`sentido`	string	baja = resta puntos · sube = suma puntos. baja \| sube
`hecho`	string	El hecho de registro público que produjo el renglón, con su fecha o período cuando lo tiene.
`seccion`	string \| null	Bloque de la ficha (y de esta misma respuesta) donde está el dato: bcra_deuda, bcra_cheques, historial, sanciones, repsal, contratos, comercio-exterior, estados-contables, paritarias, personas.
`calculado_el`	date-time
`nota`	string	El encuadre: qué es y qué no es.
`consultado_el`	date-time

Búsqueda de empresas

1 crédito por página

GET/v1/busqueda

Búsqueda sobre el padrón completo (~1,3M de empresas). Todos los parámetros son opcionales y se combinan entre sí (AND): texto, forma legal, ubicación, actividad, estado fiscal, rango de capital, los sellos booleanos (importador, exportador, empleador, contratista del Estado, deuda BCRA…) y una zona (un círculo con cerca y radio_km, un recuadro o un departamento). Devuelve 10 resultados por página con los créditos gratis de alta y 50 para cuentas con packs o plan pago. Para el detalle completo de una empresa usá /empresa con su CUIT.

Parámetros

qstringopcional

Búsqueda textual por razón social.

forma_legalstringopcional

Forma legal. Acepta la sigla con puntos o en mayúsculas (S.R.L., SA); un valor que no es ninguno de la lista es un 400 forma_legal_invalida, nunca una búsqueda sin el filtro.

Ver los 29 valores posibles

sasrlsasscascssociedad_colectivacooperativafundacionasociacion_civilmutualutefideicomisosucursal_extranjeraothersociedad_capital_industriasociedad_estadosociedad_hechosociedad_seccion_ivfederacioncamarareligiosaagrupacion_colaboracionconsorcio_cooperacionconsorcio_phsgrcapitalizacion_ahorrosucursal_nacionalpersona_humanaprofesional_matriculado

Ejemplo: sas

jurisdiccionstringopcional

Provincia o Ciudad Autónoma de Buenos Aires. Acepta las variantes de uso (CABA, Capital Federal, Bs As, sin tildes ni mayúsculas); un valor que no es ninguna de las 24 jurisdicciones es un 400 jurisdiccion_invalida con la lista.

Ver los 24 valores posibles

Ciudad Autónoma de Buenos AiresBuenos AiresCatamarcaChacoChubutCórdobaCorrientesEntre RíosFormosaJujuyLa PampaLa RiojaMendozaMisionesNeuquénRío NegroSaltaSan JuanSan LuisSanta CruzSanta FeSantiago del EsteroTierra del FuegoTucumán

Ejemplo: Córdoba

ciudadstringopcional

Ciudad o localidad.

actividadstringopcional

Código de actividad AFIP. Matchea la actividad principal (actividad.codigo) y también cualquiera de las vigentes que la empresa declara ante ARCA (actividades[].codigo de la ficha). Hasta 6 dígitos, con o sin los ceros de adelante (011211 y 11211 son el mismo código); otra cosa es un 400 actividad_invalida.

Ejemplo: 620100

estado_fiscalstringopcional

Estado ante ARCA. Un valor fuera de la lista es un 400 estado_fiscal_invalido.

activainactivabajasuspendidaunknown

capitalstringopcional

Rango de capital del último balance publicado (excluye empresas sin balance; un valor fuera de la lista es un 400 capital_invalido). lt-1m = Menos de $1M, 1m-10m = $1M a $10M, 10m-100m = $10M a $100M, gt-100m = Más de $100M.

lt-1m1m-10m10m-100mgt-100m

importadorbooleanopcional

true = solo empresas con el sello "Importadora". Con despachos de importación registrados a su CUIT.

exportadorbooleanopcional

true = solo empresas con el sello "Exportadora". Con exportaciones registradas o habilitación de exportador.

empleadorbooleanopcional

true = solo empresas con el sello "Empleadora". Declarada empleadora ante ARCA. Cobertura parcial: el dato se conoce para las empresas ya enriquecidas con el padrón fiscal, no para todo el universo.

contratistabooleanopcional

true = solo empresas con el sello "Contratista del Estado". Con contratos u órdenes de compra del Estado adjudicados (no cuenta ofertas sin adjudicación).

deuda_bcrabooleanopcional

true = solo empresas con el sello "Con deuda BCRA". Con deuda informada por alguna entidad en la central de deudores del BCRA.

cheque_rechazadobooleanopcional

true = solo empresas con el sello "Con cheques rechazados". Con cheques rechazados informados por el BCRA.

concurso_quiebrabooleanopcional

true = solo empresas con el sello "En concurso o quiebra". Con concurso preventivo o quiebra publicados en boletines oficiales.

sancionadabooleanopcional

true = solo empresas con el sello "Sancionada (UIF/CNV/BCRA)". Con sanciones administrativas publicadas.

apocbooleanopcional

true = solo empresas con el sello "En base APOC". Incluida en la base APOC de ARCA (facturas apócrifas).

repsalbooleanopcional

true = solo empresas con el sello "Sanciones laborales (REPSAL)". Con sanciones vigentes en el Registro Público de Empleadores con Sanciones Laborales.

pepbooleanopcional

true = solo empresas con el sello "Vinculada a funcionario (PEP)". Con al menos un dirigente identificado como persona expuesta políticamente.

cercastringopcional

Las empresas dentro de un círculo: latitud y longitud del centro en grados decimales. Se compara contra el domicilio desde el que opera cada sociedad. Va con radio_km; no se combina con recuadro ni departamento (400 zona_duplicada).

Ejemplo: -34.6037,-58.3816

radio_kmstringopcional

Radio del círculo de cerca, en kilómetros: mayor que 0 y hasta 50. Por defecto 1.

Ejemplo: 2.5

recuadrostringopcional

Las empresas dentro de un recuadro: oeste,sur,este,norte en grados decimales, de hasta 25 grados² (fuera de eso, 400 recuadro_invalido).

Ejemplo: -58.53,-34.71,-58.33,-34.53

departamentostringopcional

Las empresas de un departamento o partido: el código INDEC de 5 dígitos (el mismo que devuelve geo.departamento_id en /empresa con campos=geo).

Ejemplo: 06441

paginaintegeropcional

Página (1-400). Fuera de rango se ajusta al máximo, no da error.

Request

curl "https://indicadores.ar/v1/busqueda?importador=true&actividad=463111&jurisdiccion=Mendoza" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "total": 42,
  "pagina": 1,
  "por_pagina": 50,
  "total_paginas": 1,
  "resultados": [
    {
      "cuit": "30...",
      "razon_social": "...",
      "forma_legal": "srl",
      "jurisdiccion": "Mendoza",
      "ciudad": "Mendoza",
      "actividad": { "codigo": "463111", "nombre": "Venta al por mayor de productos..." },
      "fecha_constitucion": "2011-03-11",
      "capital_ultimo_balance": "150000000",
      "estado_fiscal": "activa"
    }
  ]
}

Campos de la respuesta (16)

Campo	Tipo	Descripción
`total`	integer	Total real de resultados del filtro, aunque no sea todo navegable.
`pagina`	integer
`por_pagina`	integer
`total_paginas`	integer
`resultados`	array
`cuit`	string
`razon_social`	string
`forma_legal`	string \| null
`jurisdiccion`	string \| null
`ciudad`	string \| null
`actividad`	object
`codigo`	string \| null
`nombre`	string \| null
`fecha_constitucion`	date \| null
`capital_ultimo_balance`	string \| null
`estado_fiscal`	string

Búsqueda de dirigentes

1 crédito por página

GET/v1/busqueda-personas

Busca personas (directores, socios, gerentes, síndicos, apoderados) por nombre y devuelve cuántas empresas tiene vinculadas cada una. Para el detalle usá /persona con el CUIT.

Parámetros

qstringrequerido

Nombre a buscar (mínimo 3 caracteres).

Ejemplo: perez garcia

paginaintegeropcional

Página (1-50). Fuera de rango se ajusta al máximo, no da error.

Request

curl "https://indicadores.ar/v1/busqueda-personas?q=perez%20garcia" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "total": 12,
  "pagina": 1,
  "por_pagina": 20,
  "resultados": [
    { "cuit": "20...", "nombre_completo": "PEREZ GARCIA JUAN", "funcionario_publico": false, "empresas": 3 }
  ]
}

Campos de la respuesta (8)

Campo	Tipo	Descripción
`total`	integer	Total real de resultados del filtro, aunque no sea todo navegable.
`pagina`	integer
`por_pagina`	integer
`resultados`	array
`cuit`	string
`nombre_completo`	string
`funcionario_publico`	boolean
`empresas`	integer	Cantidad de empresas vinculadas.

Ficha de persona

1 crédito

GET/v1/persona

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.

Parámetros

cuitstringrequerido

CUIT/CUIL de la persona (11 dígitos, con o sin guiones).

Ejemplo: 30500010912

Request

curl "https://indicadores.ar/v1/persona?cuit=20123456786" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "ficha": "persona",
  "ficha_nota": null,
  "cuit": "20214567890",
  "alcance": "registro",
  "alcance_nota": null,
  "nombre_completo": "PEREZ, JUAN CARLOS",
  "funcionario_publico": false,
  "fiscal": { "condicion": "responsable_inscripto", "monotributo_categoria": null, "monotributo_actividad": null, "iva": "AC", "ganancias": "AC", "actividad": "Servicios de asesoramiento, dirección y gestión empresarial", "estado": "activa", "domicilio": "BRANDSEN 2350, BAHIA BLANCA, BUENOS AIRES", "empleador": true, "empleador_al": "2026-09-12", "padron_al": "2026-09-12" },
  "empresas": [
    { "cuit": "30712345678", "razon_social": "MOLINOS DEL SUR S.A.", "forma_legal": "sa", "jurisdiccion": "Buenos Aires", "roles": ["presidente", "socio"] },
    { "cuit": "30709876543", "razon_social": "HARINAS PATAGONICAS S.R.L.", "forma_legal": "srl", "jurisdiccion": "Río Negro", "roles": ["gerente"] },
    { "cuit": "30655544332", "razon_social": "AGRO SUR S.A.", "forma_legal": "sa", "jurisdiccion": "Buenos Aires", "roles": ["director"] }
  ],
  "empresas_total": 3,
  "bcra_consultado_el": "2026-09-10T03:12:00.000Z",
  "deudas_bcra": { "periodo": "202608", "peor_situacion": 1, "situacion_principal": 1, "situacion_principal_label": "Normal", "deuda_total_miles": 2300, "entidades": 2, "entidades_detalle": [ { "entidad": "BANCO SANTANDER ARGENTINA S.A.", "situacion": 1, "situacion_label": "Normal", "deuda_miles": 2000, "dias_atraso": 0, "refinanciado": false, "en_juicio": false } ] },
  "cheques_rechazados": null,
  "consultado_el": "2026-09-11T14:00:00.000Z"
}

Campos de la respuesta (54)

Campo	Tipo	Descripción
`ficha`	string	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. empresa \| persona
`ficha_nota`	string \| null	Explica por qué la ficha no es la del endpoint pedido. Null cuando lo es.
`cuit`	string
`alcance`	string	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. registro \| padron
`alcance_nota`	string \| null	Explica el alcance cuando es padron; null en una ficha completa.
`nombre_completo`	string
`funcionario_publico`	boolean
`fiscal`	object \| null	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 \| null	monotributo, responsable_inscripto, autonomo, con_actividad…
`monotributo_categoria`	string \| null	Letra A-K: el techo de facturación anual declarado. Del padrón masivo de ARCA.
`monotributo_actividad`	string \| null	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`	string \| null	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. AC \| EX \| NI \| NA \| XN \| AN
`ganancias`	string \| null	Código de ARCA: AC inscripto, EX exento, NI no inscripto, NC no corresponde. Null = en blanco. AC \| EX \| NI \| NC
`actividad`	string \| null
`estado`	string \| null	activa \| inactiva \| unknown
`domicilio`	string \| null	Domicilio fiscal declarado.
`empleador`	boolean \| null	true = inscripta como empleadora (aportes y contribuciones). null = el padrón la publica en blanco.
`empleador_al`	date \| null	Fecha del corte del padrón al que corresponde empleador.
`padron_al`	date \| null	Fecha del corte del padrón masivo de ARCA.
`empresas`	array	Empresas vinculadas con los roles que ocupa en cada una. Trae hasta 100, por razón social; empresas_total dice cuántas son.
`cuit`	string
`razon_social`	string
`forma_legal`	string \| null
`jurisdiccion`	string \| null
`roles`	array<string>
`empresas_total`	integer	Cuántas empresas tiene vinculadas la persona. Mayor que el largo de empresas cuando la lista vino recortada.
`bcra_consultado_el`	date-time \| null	Ú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 \| null	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`	array	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 \| null	Cheques rechazados informados por el BCRA. Null sin registros.
`total`	integer
`impagos`	integer
`detalle`	array	Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero).
`numero`	string
`entidad`	string
`fecha`	date
`monto`	string
`causal`	string \| null
`pagado`	boolean
`fecha_pago`	date \| null
`consultado_el`	date-time

Llamados a licitación

1 crédito por página

GET/v1/llamados

Llamados a licitación y contrataciones públicas todavía sin adjudicar, detectados en los boletines oficiales nacionales y provinciales: organismo, objeto, rubro, expediente y fecha de apertura de ofertas. Todos los parámetros son opcionales; sin filtros devuelve los más recientes.

Parámetros

qstringopcional

Búsqueda textual por organismo, objeto, rubro o procedimiento.

rubrostringopcional

Categoría del llamado. Un valor fuera de la lista es un 400 rubro_invalido.

suministrosserviciosobraslocaciones

organismostringopcional

Slug del organismo convocante (el de organismo_slug en los resultados). Un slug que no corresponde a ningún organismo con llamados es un 400 organismo_invalido.

abiertasbooleanopcional

true = solo llamados con fecha de apertura de ofertas futura.

paginaintegeropcional

Página (1-500). Fuera de rango se ajusta al máximo, no da error.

Request

curl "https://indicadores.ar/v1/llamados?rubro=obras&abiertas=true" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "total": 214,
  "pagina": 1,
  "por_pagina": 20,
  "total_paginas": 11,
  "resultados": [
    {
      "organismo": "Ministerio de Obras Públicas",
      "organismo_slug": "ministerio-de-obras-publicas",
      "procedimiento": "Licitación Pública N° 12/2026",
      "rubro": "OBRAS",
      "objeto": "...",
      "expediente": "EX-2026-...",
      "fecha_apertura": "2026-09-02T12:00:00.000Z",
      "fecha_publicacion": "2026-08-14",
      "fuente": "boletin_nacional",
      "url_ficha": "https://indicadores.ar/contrataciones/llamados/aviso/..."
    }
  ]
}

Campos de la respuesta (15)

Campo	Tipo	Descripción
`total`	integer	Total real de resultados del filtro, aunque no sea todo navegable.
`pagina`	integer
`por_pagina`	integer
`total_paginas`	integer
`resultados`	array
`organismo`	string
`organismo_slug`	string \| null
`procedimiento`	string \| null
`rubro`	string \| null	Categoría y subrubro del boletín (ej: SUMINISTROS - EFECTOS VARIOS).
`objeto`	string \| null
`expediente`	string \| null
`fecha_apertura`	date-time \| null	Fecha y hora (ART) de apertura de ofertas.
`fecha_publicacion`	date
`fuente`	string \| null	Boletín oficial de origen.
`url_ficha`	string \| null

Ranking de importadores

1 crédito por página

GET/v1/importadores

Empresas con despachos de importación registrados, agregados por mes, posición NCM y país de origen y resueltos a CUIT, ordenadas por monto FOB descendente. Todos los filtros son opcionales; sin filtros devuelve el ranking de los últimos 12 meses con datos. Es un agregado: para el detalle de una empresa (series, tops, CIF estimado) usá /empresa, y para filtrar el padrón por el sello importador usá /busqueda?importador=true.

Parámetros

ncmstringopcional

Prefijo de posición NCM: capítulo (84), partida (8471) o posición completa.

Ejemplo: 8471

paisstringopcional

País de origen. Acepta el código del nomenclador aduanero (el de principales_origenes de /empresa) o el ISO 3166-1 alpha-2. Con el ISO entran todos los códigos de ese país, zonas francas incluidas.

Ejemplo: CN

jurisdiccionstringopcional

Provincia o Ciudad Autónoma de Buenos Aires de la empresa. Acepta las variantes de uso (CABA, Capital Federal, Bs As, sin tildes ni mayúsculas); un valor que no es ninguna de las 24 jurisdicciones es un 400 jurisdiccion_invalida con la lista.

Ver los 24 valores posibles

Ejemplo: Córdoba

actividadstringopcional

Código de actividad AFIP de la empresa (el de actividad.codigo). Hasta 6 dígitos, con o sin los ceros de adelante (011211 y 11211 son el mismo código); otra cosa es un 400 actividad_invalida.

Ejemplo: 620100

desdestringopcional

Período inicial AAAAMM (default 11 meses antes de hasta).

Ejemplo: 202501

hastastringopcional

Período final AAAAMM (default el último mes con datos).

Ejemplo: 202607

paginaintegeropcional

Página (1-250). Fuera de rango se ajusta al máximo, no da error.

Request

curl "https://indicadores.ar/v1/importadores?ncm=8471&jurisdiccion=Córdoba" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "total": 380,
  "pagina": 1,
  "por_pagina": 20,
  "total_paginas": 19,
  "periodo_desde": "202508",
  "periodo_hasta": "202607",
  "resultados": [
    {
      "cuit": "30...",
      "razon_social": "...",
      "jurisdiccion": "Córdoba",
      "fob_usd": 1250000,
      "cif_usd_estimado": 1310000,
      "flete_y_seguro_usd_estimado": 60000,
      "cobertura_cif_pct": 97.4,
      "tributos_totales_usd": 210000,
      "kilos": 84000,
      "despachos": 42,
      "items": 120,
      "meses_con_operaciones": 11,
      "posiciones_ncm": 6,
      "paises_origen": 3,
      "url_ficha": "https://indicadores.ar/empresa/30..."
    }
  ]
}

Campos de la respuesta (22)

Campo	Tipo	Descripción
`total`	integer	Total real de resultados del filtro, aunque no sea todo navegable.
`pagina`	integer
`por_pagina`	integer
`total_paginas`	integer
`periodo_desde`	string	Ventana AAAAMM efectivamente consultada.
`periodo_hasta`	string
`resultados`	array
`cuit`	string
`razon_social`	string
`jurisdiccion`	string \| null
`fob_usd`	number
`cif_usd_estimado`	number \| null	ESTIMADO, no declarado. Null cuando la estimación no cubre suficiente FOB del importador en el período.
`flete_y_seguro_usd_estimado`	number \| null	ESTIMADO. Flete MÁS seguro; no se pueden separar.
`cobertura_cif_pct`	number	Porcentaje del FOB del importador con valor CIF estimado.
`tributos_totales_usd`	number \| null	Tributos efectivamente liquidados (declarados).
`kilos`	number \| null	Peso neto sólo de las operaciones cuya unidad estadística lo mide.
`despachos`	integer
`items`	integer
`meses_con_operaciones`	integer
`posiciones_ncm`	integer
`paises_origen`	integer
`url_ficha`	string

Serie económica

gratis

GET/v1/serie

Valores de una serie entre dos fechas. Las series diarias se pueden pedir por día o llevadas a meses: mensual_promedio promedia los días hábiles del mes (los fines de semana repiten el viernes y no entran) y mensual_cierre toma el último día hábil. Cada mes informa con cuántos días se calculó. Las series mensuales (IPC, comercio exterior) devuelven un punto por mes. Sin fechas, devuelve el último año.

Parámetros

tipostringrequerido

Serie a consultar (el catálogo completo está en /series).

Ver los 15 valores posibles

dolar_oficialdolar_bluedolar_mepdolar_cclipc_mensualipc_interanualuvaiclcerriesgo_paisbadlarplazo_fijoexportacionesimportacionesbalanza_comercial

Ejemplo: dolar_mep

desdestringopcional

Fecha inicial, AAAA-MM-DD (incluida). Default: un año antes de hasta.

Ejemplo: 2025-01-01

hastastringopcional

Fecha final, AAAA-MM-DD (incluida). Default: el último dato.

Ejemplo: 2025-12-31

agregacionstringopcional

Cómo se devuelve una serie diaria. La diaria admite hasta 10 años por llamada; por mes, cualquier rango.

diariamensual_promediomensual_cierre

Ejemplo: mensual_promedio

Request

curl "https://indicadores.ar/v1/serie?tipo=dolar_mep&desde=2025-01-01&hasta=2025-03-31&agregacion=mensual_promedio" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "tipo": "dolar_mep",
  "nombre": "Dólar MEP (venta)",
  "unidad": "ARS por USD",
  "frecuencia": "diaria",
  "agregacion": "mensual_promedio",
  "desde": "2025-01-01",
  "hasta": "2025-03-31",
  "ultimo_dato": "2026-09-16",
  "puntos": [
    { "periodo": "2025-01", "valor": 1195.31, "dias_con_dato": 22 },
    { "periodo": "2025-02", "valor": 1203.82, "dias_con_dato": 20 },
    { "periodo": "2025-03", "valor": 1224.05, "dias_con_dato": 19 }
  ]
}

Campos de la respuesta (13)

Campo	Tipo	Descripción
`tipo`	string	dolar_oficial \| dolar_blue \| dolar_mep \| dolar_ccl \| ipc_mensual \| ipc_interanual \| uva \| icl \| cer \| riesgo_pais \| badlar \| plazo_fijo \| exportaciones \| importaciones \| balanza_comercial
`nombre`	string
`unidad`	string
`frecuencia`	string	diaria \| mensual
`agregacion`	string	diaria \| mensual_promedio \| mensual_cierre \| mensual
`desde`	date
`hasta`	date
`ultimo_dato`	date \| null	Fecha del último valor publicado de la serie.
`puntos`	array
`fecha`	date	Sólo con agregacion=diaria.
`periodo`	string	AAAA-MM. Con agregación mensual o en series mensuales.
`valor`	number
`dias_con_dato`	integer	Días hábiles con los que se calculó el mes (series diarias agregadas por mes).

Inflación entre dos meses

gratis

GET/v1/inflacion

Encadena las variaciones mensuales del IPC nacional del INDEC. El mes desde es la base: la primera variación que entra es la del mes siguiente, así que de agosto a agosto son doce meses y da el interanual publicado. Si falta un mes adentro del rango no se calcula (422 con el mes que falta): un acumulado con un hueco es un número inventado.

Parámetros

desdestringrequerido

Mes base, AAAA-MM.

Ejemplo: 2025-08

hastastringopcional

Mes final, AAAA-MM. Default: el último IPC publicado.

Ejemplo: 2026-08

Request

curl "https://indicadores.ar/v1/inflacion?desde=2025-08&hasta=2026-08" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "desde": "2025-08",
  "hasta": "2026-08",
  "meses": 12,
  "factor": 1.335,
  "inflacion_acumulada_pct": 33.5,
  "anualizada_pct": 33.5,
  "mensual": [ { "periodo": "2025-09", "pct": 2.1 }, { "periodo": "2025-10", "pct": 2.3 } ],
  "serie": "Inflación mensual (IPC nacional, INDEC)",
  "nota": "El mes 'desde' es la base: la primera variación que entra es la del mes siguiente. De agosto a agosto son doce meses."
}

Campos de la respuesta (11)

Campo	Tipo	Descripción
`desde`	string
`hasta`	string
`meses`	integer	Cantidad de variaciones mensuales encadenadas.
`factor`	number	Multiplicador: pesos de desde × factor = pesos de hasta.
`inflacion_acumulada_pct`	number
`anualizada_pct`	number \| null	Sólo con 12 meses o más.
`mensual`	array
`periodo`	string
`pct`	number
`serie`	string
`nota`	string

Convertir montos mensuales

gratis

GET/v1/convertir

Convierte una serie de montos en pesos, uno por mes (facturación, sueldos, ventas), a dólares con la cotización de cada mes (promedio de días hábiles o cierre) o a pesos de un mes dado ajustados por el IPC. Cada fila trae el tipo de cambio o el factor usado; los meses sin dato van a sin_dato y no suman en los totales.

Parámetros

montosstringrequerido

Pares AAAA-MM:monto separados por coma, hasta 120. El monto lleva punto decimal y ningún separador de miles.

Ejemplo: 2025-01:42000000,2025-02:45100000

astringrequerido

Destino: dólares de cada tipo o pesos ajustados por inflación.

usd_oficialusd_blueusd_mepusd_cclars_hoy

Ejemplo: usd_mep

cotizacionstringopcional

Para los destinos en dólares. Default: promedio_mes.

promedio_mescierre_mes

hastastringopcional

Para ars_hoy: mes en cuyos pesos se expresa, AAAA-MM. Default: el último IPC.

Request

curl "https://indicadores.ar/v1/convertir?a=usd_mep&montos=2025-01:42000000,2025-02:45100000" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "a": "usd_mep",
  "cotizacion": "promedio_mes",
  "serie": "Dólar MEP (venta)",
  "resultados": [
    { "periodo": "2025-01", "ars": 42000000, "tipo_de_cambio": 1195.31, "usd": 35137.36, "dias_con_dato": 22 },
    { "periodo": "2025-02", "ars": 45100000, "tipo_de_cambio": 1203.82, "usd": 37463.83, "dias_con_dato": 20 }
  ],
  "sin_dato": [],
  "total_ars": 87100000,
  "total_usd": 72601.19
}

Campos de la respuesta (16)

Campo	Tipo	Descripción
`a`	string	usd_oficial \| usd_blue \| usd_mep \| usd_ccl \| ars_hoy
`cotizacion`	string	Sólo destinos en dólares.
`expresado_en`	string	Sólo ars_hoy.
`serie`	string
`resultados`	array
`periodo`	string
`ars`	number
`tipo_de_cambio`	number	Destinos en dólares.
`usd`	number	Destinos en dólares.
`dias_con_dato`	integer	Destinos en dólares.
`factor`	number	ars_hoy.
`ars_ajustado`	number	ars_hoy.
`sin_dato`	array<string>	Meses pedidos sin cotización o sin IPC.
`total_ars`	number
`total_usd`	number	Destinos en dólares.
`total_ars_ajustado`	number	ars_hoy.

Catálogo de series económicas

gratis

GET/v1/series

Las series que se pueden consultar con /serie, /inflacion y /convertir: nombre, unidad, frecuencia y la fecha del primer y del último dato.

Request

curl "https://indicadores.ar/v1/series" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "series": [
    { "tipo": "dolar_mep", "nombre": "Dólar MEP (venta)", "unidad": "ARS por USD", "frecuencia": "diaria", "nota": null, "desde": "2018-10-29", "hasta": "2026-09-16" },
    { "tipo": "ipc_mensual", "nombre": "Inflación mensual (IPC nacional, INDEC)", "unidad": "% de variación mensual", "frecuencia": "mensual", "nota": null, "desde": "1943-02-28", "hasta": "2026-08-31" }
  ]
}

Campos de la respuesta (8)

Campo	Tipo	Descripción
`series`	array
`tipo`	string	dolar_oficial \| dolar_blue \| dolar_mep \| dolar_ccl \| ipc_mensual \| ipc_interanual \| uva \| icl \| cer \| riesgo_pais \| badlar \| plazo_fijo \| exportaciones \| importaciones \| balanza_comercial
`nombre`	string
`unidad`	string
`frecuencia`	string	diaria \| mensual
`nota`	string \| null
`desde`	date \| null
`hasta`	date \| null

Autocomplete

gratis

GET/v1/sugerencias

Hasta 8 empresas que matchean un texto parcial, pensado para autocompletar formularios. Gratis, con cupo de 1.000 consultas por día.

Parámetros

qstringrequerido

Texto parcial (mínimo 2 caracteres).

Ejemplo: mercado

Request

curl "https://indicadores.ar/v1/sugerencias?q=mercado" \
  -H "api-key: TU_API_KEY"

Respuesta (recortada)

{
  "resultados": [
    { "cuit": "30703088534", "razon_social": "MERCADOLIBRE S.R.L.", "jurisdiccion": "Ciudad Autónoma de Buenos Aires" }
  ]
}

Campos de la respuesta (4)

Campo	Tipo	Descripción
`resultados`	array
`cuit`	string
`razon_social`	string
`jurisdiccion`	string \| null

Saldo de créditos

gratis

GET/v1/creditos

Créditos disponibles de tu cuenta y consumo del mes en curso.

Request

curl "https://indicadores.ar/v1/creditos" -H "api-key: TU_API_KEY"

Respuesta (recortada)

{ "creditos_disponibles": 87, "consumidos_este_mes": 13 }

Campos de la respuesta (2)

Campo	Tipo	Descripción
`creditos_disponibles`	integer
`consumidos_este_mes`	integer

Servidor MCP (agentes de IA)

Toda la API también está disponible como servidor MCP en https://indicadores.ar/mcp con las tools ficha_empresa, buscar_empresas, buscar_dirigentes, ficha_persona, buscar_llamados, buscar_importadores, serie_economica, inflacion_entre_fechas, convertir_montos, series_disponibles, sugerencias y saldo_creditos. Usa tu misma API key (Bearer) y los mismos créditos (las de series económicas son gratis); listar las tools no requiere key. Metadata en /.well-known/mcp.json.

Claude Code

claude mcp add --transport http indicadores https://indicadores.ar/mcp \
  --header "Authorization: Bearer TU_API_KEY"

Claude Desktop / claude.ai (conector custom)

URL del servidor: https://indicadores.ar/mcp
Header: Authorization: Bearer TU_API_KEY

Cursor / VS Code (mcp.json)

{
  "mcpServers": {
    "indicadores": {
      "url": "https://indicadores.ar/mcp",
      "headers": { "Authorization": "Bearer TU_API_KEY" }
    }
  }
}

Próximamente: alertas por webhook

En construcción. El contrato de abajo es el que se va a publicar; si integrás hoy, diseñá contra esto.

Las mismas alertas que hoy llegan por mail (cambios de autoridades, quiebras y concursos, situación BCRA, cheques rechazados, APOC y REPSAL, menciones en el boletín, contratos, comercio exterior), entregadas a un endpoint tuyo, con la cartera de CUITs de empresas y personas gestionada por API. Un POST por evento, firmado con HMAC, con id idempotente y reintentos con backoff durante 39 horas.

GET	/v1/seguimientos	La cartera: CUITs seguidos, con qué eventos y desde cuándo.
POST	/v1/seguimientos	Agrega hasta 500 CUITs de empresas o personas por llamada, idempotente. 1 crédito cada 100 agregados.
DELETE	/v1/seguimientos	Saca CUITs de la cartera.
GET	/v1/webhooks	Los endpoints configurados (hasta 3 por cuenta).
POST	/v1/webhooks	Crea uno con su URL y el filtro de eventos. Devuelve el secreto de firma una sola vez.
DELETE	/v1/webhooks/{id}	Lo da de baja.
POST	/v1/webhooks/{id}/prueba	Manda un evento de prueba firmado y devuelve qué respondió tu endpoint.
GET	/v1/webhooks/{id}/entregas	Las últimas 200 entregas: evento, intento, status, latencia, próximo reintento.

Cuerpo de cada evento

{
  "id": "wn_18234911",
  "tipo": "cambio_autoridades",
  "fecha_evento": "2026-09-10",
  "detectado_el": "2026-09-11T03:12:44.000Z",
  "sujeto": { "clase": "empresa", "cuit": "30707006397", "razon_social": "GRUPO ARCOR SOCIEDAD ANONIMA" },
  "titulo": "Designación de directorio",
  "aviso_url": "https://www.boletinoficial.gob.ar/detalleAviso/segunda/A1514958/20260910",
  "ficha": "https://indicadores.ar/v1/empresa?cuit=30707006397",
  "datos": { "orden_del_dia": "…" }
}

Firma en el header X-Indicadores-Firma (t=<unix>,v1=<hmac_sha256(secreto, t.cuerpo)>), id del evento en X-Indicadores-Evento-Id (se repite en cada reintento: deduplicá por ese id). Cualquier respuesta que no sea 2xx reintenta: 1 min, 5 min, 30 min, 2 h, 12 h, 24 h. Tres días con todas las entregas fallidas desactivan el webhook y te avisamos por mail. Agregar CUITs a la cartera cuesta 1 crédito cada 100; las entregas no se cobran. Si lo necesitás antes o con otro contrato, escribinos a [email protected].

Changelog

1 de octubre de 2026: no se cobra lo que no llega ni los campos que vienen vacíos. Un campo adicional suma créditos sólo si vuelve con dato (geo o empleados en null, beneficiarios sin personas, una serie sin períodos o un score sin dimensiones evaluadas no se cobran), y los headers x-creditos-cobrados y x-campos-sin-cargo dicen cuánto costó la respuesta. Una respuesta que no llegó a entregarse (timeout o conexión cortada) no se debita. En /llamados, un rubro fuera de la lista o un organismo sin llamados es un 400 sin cargo: antes el rubro se ignoraba y el organismo daba cero, y las dos se cobraban.
22 de septiembre de 2026: la ventana de la consulta repetida sin cargo pasa de 30 a 5 minutos. Cubre el reintento de una respuesta que no llegó; volver a correr la misma consulta más tarde se cobra.
21 de septiembre de 2026: /empresa con el CUIT de una persona responde su ficha de persona en vez de un 404 (y /persona con el de una empresa, la de empresa), cobrada como la ficha que se entregó. Las dos fichas traen ficha y ficha_nota para distinguirlo. Los filtros de /busqueda y /importadores aceptan las variantes de uso (CABA, Capital Federal, S.R.L., el código de actividad con ceros adelante), y un valor que no corresponde a ninguno es un 400 con los válidos: antes devolvía cero resultados y se cobraba, o descartaba el filtro sin avisar. La misma consulta repetida dentro de los 30 minutos no se vuelve a cobrar.
11 de septiembre de 2026: las fichas de empresa y de persona ya no responden 404 para un CUIT que existe. Una empresa que nunca publicó un acto societario pero figura en el padrón fiscal con actividad (sociedades de hecho, unipersonales, productores) responde 200 con alcance: padron: identidad, forma jurídica, actividad, estado, domicilio fiscal, fecha de contrato y los bloques que se indexan por CUIT; los societarios vienen vacíos y alcance_nota lo dice. Lo mismo para personas. El 404 queda para el CUIT que no existe o no tiene actividad; si el padrón no contesta a tiempo la llamada es un 503 que no se cobra. eventos pasa de 8 a 15 tipos de acto (asambleas, cambios de autoridades y de domicilio, cesiones, aumentos de capital, cambios de objeto y de denominación), los mismos que muestra la ficha web. Nuevo bcra_consultado_el en las dos fichas: cuándo se leyó la central de deudores para ese CUIT; en null, los bloques BCRA en null no afirman que no haya deuda (pedir la ficha encola la consulta). directorio_vigente ya estaba en la respuesta y faltaba en esta documentación. El 401 de una key mal pegada ahora dice qué llegó.
Septiembre 2026 (score): campo adicional score (+5 créditos) en la ficha de empresa: el score de riesgo de 0 a 100 con su nivel, cuántas dimensiones se evaluaron y el desglose de qué lo sube y qué lo baja, cada renglón con el hecho de registro público que lo produjo y el bloque de la ficha donde está el dato. Es un resumen de hechos con criterio explícito, no una calificación crediticia; el desglose dice qué pesa y en qué sentido, no cuántos puntos. Se calcula en el momento con los mismos datos que la ficha web, así que la API y la pantalla dicen lo mismo.
Septiembre 2026: tres pedidos de quien ya usa la API en producción. Cada elemento de eventos y de dirigentes en la ficha de empresa lleva aviso_url, el link al aviso del boletín oficial del que salió el dato (null cuando la fila viene de un padrón registral y no de un aviso). El historial societario ya no se recorta: viaja completo, y el bloque nuevo cobertura_societaria declara hasta qué fecha llega el archivo digitalizado de la jurisdicción de registro, para distinguir "no pasó nada" de "no hay archivo". Campo adicional situacion_historica (+1 crédito): la serie mensual completa de la central de deudores del BCRA, con deuda total, situación principal, peor situación y entidades por período.
Agosto 2026 (rediseño v1): la búsqueda de empresas suma el rango de capital y los sellos booleanos combinables (importador, exportador, empleador, contratista, deuda_bcra y más). Campos adicionales con campos= en la ficha de empresa: beneficiarios (+2 créditos) reemplaza al endpoint /beneficiarios, que se eliminó. El ranking de importadores filtra por actividad y renombró nombre a razon_social. Documentación nueva con la lista completa de campos por endpoint y OpenAPI generado desde el contrato.
Agosto 2026: ejemplos de respuesta en toda la referencia. Topes de paginación documentados por endpoint y cupo diario del autocomplete.
Julio 2026: endpoints /llamados e /importadores; detalle de comercio exterior (CIF, flete, vía, aduana) en la ficha de empresa; servidor MCP publicado en el registry oficial.

Documentación de la API

Autenticación

Créditos y costos

Límites y paginación

Errores

Endpoints

Ficha de empresa

Parámetros

Campos adicionales

Búsqueda de empresas

Parámetros

Búsqueda de dirigentes

Parámetros

Ficha de persona

Parámetros

Llamados a licitación

Parámetros

Ranking de importadores

Parámetros

Serie económica

Parámetros

Inflación entre dos meses

Parámetros

Convertir montos mensuales

Parámetros

Catálogo de series económicas

Autocomplete

Parámetros

Saldo de créditos

Servidor MCP (agentes de IA)

Claude Code

Claude Desktop / claude.ai (conector custom)

Cursor / VS Code (mcp.json)

Próximamente: alertas por webhook

Changelog

El registro, vigilado