{"openapi":"3.0.3","info":{"title":"API de Indicadores Argentina","version":"1.1","description":"API pública de datos de empresas y dirigentes de Argentina: registros societarios de las 24\njurisdicciones (Boletines Oficiales + registros públicos), situación crediticia BCRA,\ncomercio exterior, contratos con el Estado y más.\n\n## Autenticación\nTodas las rutas requieren una API key en el header `api-key`. Creá la tuya gratis en\nhttps://indicadores.ar/api-empresas (incluye 100 créditos de regalo).\n\n## Créditos\nCada llamada exitosa (HTTP 200) consume créditos según la ruta; las respuestas de error no\nse cobran. El header `x-creditos-restantes` de cada respuesta indica tu saldo. Algunos\nendpoints aceptan `campos=` con bloques adicionales que suman créditos.\n| Ruta | Costo |\n|------|-------|\n| /empresa | 1 crédito + campos adicionales |\n| /busqueda | 1 crédito por página |\n| /busqueda-personas | 1 crédito por página |\n| /persona | 1 crédito |\n| /llamados | 1 crédito por página |\n| /importadores | 1 crédito por página |\n| /sugerencias | gratis (cupo 1.000/día) |\n| /creditos | gratis |\n| /empresa?campos=beneficiarios | +2 créditos |\n\n## Límites\n60 requests por minuto por API key (HTTP 429 al excederlo). Los listados se navegan con\n`pagina` hasta la profundidad máxima de cada ruta (ver el parámetro en cada endpoint); el\n`total` siempre es el real. /busqueda devuelve 10 filas por página con créditos gratis y\n50 con packs o plan pago. Para volumen o integración continua: contacto@indicadores.ar.","contact":{"email":"contacto@indicadores.ar","url":"https://indicadores.ar/api-empresas"}},"servers":[{"url":"https://indicadores.ar/v1"}],"security":[{"apiKey":[]}],"paths":{"/empresa":{"get":{"operationId":"empresa","summary":"Ficha completa de una empresa por CUIT.","description":"Toda la información disponible de la empresa: identificación registral, actividad, dirigentes y socios (con % de participación cuando el aviso lo publica), vínculos con otras empresas, actos societarios (constitución, reformas, quiebras, concursos), situación crediticia BCRA banco por banco, cheques rechazados uno por uno, comercio exterior, contratos con el Estado, créditos subsidiados y sanciones. Con `campos=` se agregan bloques adicionales que suman créditos (ver la tabla de campos adicionales).\n\nCosto: 1 crédito + campos adicionales.\n\nCampos adicionales (`campos=`): `beneficiarios` (+2 créditos).","parameters":[{"name":"cuit","in":"query","required":true,"description":"CUIT de la empresa (11 dígitos, con o sin guiones).","schema":{"type":"string","example":"30500010912"}},{"name":"campos","in":"query","description":"Campos adicionales a incluir, separados por coma. Cada uno suma su costo en créditos al de la ficha. Disponibles: beneficiarios (+2).","schema":{"type":"string","example":"beneficiarios"}}],"responses":{"200":{"description":"Ficha completa de una empresa por CUIT.","content":{"application/json":{"schema":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"forma_legal":{"type":"string","nullable":true},"jurisdiccion":{"type":"string","nullable":true},"ciudad":{"type":"string","nullable":true},"domicilio_legal":{"type":"string","nullable":true,"description":"Domicilio registrado ante el registro societario (puede estar desactualizado)."},"domicilio_fiscal":{"type":"string","nullable":true,"description":"Domicilio fiscal declarado ante ARCA."},"contacto":{"type":"object","properties":{"sitios_web":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"origen":{"type":"string","enum":["registro","inferido"],"description":"`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."}}},"description":"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."},"email":{"type":"string","nullable":true,"description":"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":{"type":"string","nullable":true,"description":"Teléfono publicado por la empresa en su propio sitio."},"verificado_el":{"type":"string","format":"date","nullable":true,"description":"Fecha en que se leyó el sitio del que salieron mail y teléfono. Null cuando todavía sólo se conoce el dominio."}},"nullable":true,"description":"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)."},"fecha_constitucion":{"type":"string","format":"date","nullable":true},"actividad":{"type":"object","properties":{"codigo":{"type":"string","nullable":true,"description":"Código de actividad AFIP."},"nombre":{"type":"string","nullable":true}}},"estado_fiscal":{"type":"string"},"perfil":{"type":"object","properties":{"importador":{"type":"boolean"},"exportador":{"type":"boolean"},"empleador":{"type":"boolean"},"empleados_estimados":{"type":"integer","nullable":true}}},"capital":{"type":"object","properties":{"fecha_ultimo_balance":{"type":"string","format":"date","nullable":true},"capital_ultimo_balance":{"type":"string","nullable":true}}},"dirigentes":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"nombre_completo":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}},"funcionario_publico":{"type":"boolean"},"participacion_pct":{"type":"number","nullable":true,"description":"% del capital suscripto según el aviso societario publicado."}}},"description":"Personas vinculadas: directores, socios, gerentes, síndicos, apoderados."},"vinculos_societarios":{"type":"array","items":{"type":"object","properties":{"tipo":{"type":"string","description":"socia, ex_socia, absorbente, absorbida, beneficiaria_escision, escindente, cesionaria_fondo, cedente_fondo o vinculada."},"direccion":{"type":"string","enum":["esta_empresa_es_sujeto","esta_empresa_es_contraparte"]},"denominacion":{"type":"string"},"cuit":{"type":"string","nullable":true},"participacion_pct":{"type":"number","nullable":true},"fecha":{"type":"string","format":"date"}}},"description":"Vínculos directos con otras empresas publicados en los boletines: socias/accionistas personas jurídicas, fusiones, escisiones y transferencias de fondo de comercio."},"eventos":{"type":"array","items":{"type":"object","properties":{"tipo":{"type":"string"},"fecha":{"type":"string","format":"date"},"titulo":{"type":"string","nullable":true},"descripcion":{"type":"string","nullable":true}}},"description":"Actos societarios (constitución, reformas, fusiones, disolución, quiebra, concurso)."},"deudas_bcra":{"type":"object","properties":{"periodo":{"type":"string","description":"Período informado (AAAAMM)."},"peor_situacion":{"type":"integer","description":"1 = normal … 5 = irrecuperable."},"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)."}},"nullable":true,"description":"Situación en la central de deudores del BCRA. Null sin deuda informada."},"cheques_rechazados":{"type":"object","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","nullable":true},"pagado":{"type":"boolean"},"fecha_pago":{"type":"string","format":"date","nullable":true}}},"description":"Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero)."}},"nullable":true,"description":"Cheques rechazados informados por el BCRA. Null sin registros."},"comercio_exterior":{"type":"object","properties":{"importaciones":{"type":"object","properties":{"periodo_desde":{"type":"string","description":"Ventana AAAAMM de los totales y tops."},"periodo_hasta":{"type":"string"},"fob_usd":{"type":"number"},"items":{"type":"integer","description":"Ítems de despacho de la ventana."},"despachos":{"type":"integer","description":"Destinaciones distintas de la ventana."},"kilos":{"type":"number","nullable":true,"description":"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":{"type":"object","properties":{"cif_usd_estimado":{"type":"number"},"flete_y_seguro_usd_estimado":{"type":"number","description":"Flete MÁS seguro; no se pueden separar."},"flete_sobre_fob_pct":{"type":"number","description":"Incidencia sobre el FOB que tiene estimación, no sobre el total."},"cobertura_fob_pct":{"type":"number","description":"Porcentaje del FOB del período con valor CIF estimado."},"fob_imputado_usd":{"type":"number","description":"Parte del FOB cuyo CIF salió de una referencia externa y no de la propia operación."}},"nullable":true,"description":"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."},"tributos":{"type":"object","properties":{"derechos_usd":{"type":"number"},"tributos_totales_usd":{"type":"number"}},"nullable":true,"description":"Tributos efectivamente liquidados. A diferencia del CIF, declarados."},"principales_ncm":{"type":"array","items":{"type":"object","properties":{"ncm":{"type":"string"},"descripcion":{"type":"string","nullable":true,"description":"Descripción oficial de la posición; degrada a la partida o al capítulo cuando el nomenclador no tiene esa apertura."},"fob_usd":{"type":"number"},"items":{"type":"integer"}}}},"principales_origenes":{"type":"array","items":{"type":"object","properties":{"pais":{"type":"string","description":"Código de país de origen del nomenclador aduanero."},"pais_nombre":{"type":"string","description":"Nombre del país de origen."},"pais_iso":{"type":"string","nullable":true,"description":"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":{"type":"number"},"items":{"type":"integer"}}}},"principales_procedencias":{"type":"array","items":{"type":"object","properties":{"pais":{"type":"string"},"pais_nombre":{"type":"string"},"pais_iso":{"type":"string","nullable":true,"description":"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":{"type":"number"},"items":{"type":"integer"}}},"description":"País desde el que se despachó la mercadería, que difiere del de origen en un tercio de las operaciones."},"vias_de_transporte":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código tal como lo publica la fuente aduanera."},"descripcion":{"type":"string"},"fob_usd":{"type":"number"},"items":{"type":"integer"}}},"description":"Cómo llega la mercadería. Describe el último tramo hasta la aduana de registro."},"aduanas":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código tal como lo publica la fuente aduanera."},"descripcion":{"type":"string"},"fob_usd":{"type":"number"},"items":{"type":"integer"}}},"description":"Aduana de registro del despacho."},"regimenes":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string","description":"Código tal como lo publica la fuente aduanera."},"descripcion":{"type":"string"},"fob_usd":{"type":"number"},"items":{"type":"integer"}}},"description":"Régimen de la destinación (a consumo, courier, zona franca…)."},"serie_mensual":{"type":"array","items":{"type":"object","properties":{"periodo":{"type":"string"},"fob_usd":{"type":"number"},"items":{"type":"integer"}}},"description":"Hasta 24 meses, del más viejo al más nuevo."}},"nullable":true,"description":"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."},"exportaciones_granos":{"type":"object","properties":{"periodo_desde":{"type":"string"},"periodo_hasta":{"type":"string"},"toneladas":{"type":"number"},"declaraciones":{"type":"integer"},"principales_productos":{"type":"array","items":{"type":"object","properties":{"producto":{"type":"string"},"toneladas":{"type":"number"},"declaraciones":{"type":"integer"}}}},"serie_mensual":{"type":"array","items":{"type":"object","properties":{"periodo":{"type":"string"},"toneladas":{"type":"number"}}},"description":"Hasta 24 meses, del más viejo al más nuevo."}},"nullable":true,"description":"Exportaciones declaradas de granos y subproductos, en toneladas por producto y mes."},"exportaciones_energia":{"type":"object","properties":{"periodo_desde":{"type":"string"},"periodo_hasta":{"type":"string"},"monto_usd":{"type":"number"},"principales_productos":{"type":"array","items":{"type":"object","properties":{"producto":{"type":"string"},"monto_usd":{"type":"number"}}}},"principales_destinos":{"type":"array","items":{"type":"object","properties":{"pais":{"type":"string"},"pais_iso":{"type":"string","nullable":true,"description":"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":{"type":"number"}}}},"serie_mensual":{"type":"array","items":{"type":"object","properties":{"periodo":{"type":"string"},"monto_usd":{"type":"number"}}},"description":"Hasta 24 meses, del más viejo al más nuevo."},"ofertas_hidrocarburos":{"type":"object","properties":{"total":{"type":"integer"},"vigentes":{"type":"integer"}},"nullable":true}},"nullable":true,"description":"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."},"habilitaciones_ue":{"type":"object","properties":{"rubros":{"type":"array","items":{"type":"object","properties":{"rubro":{"type":"string"},"establecimientos":{"type":"integer"}}}}},"nullable":true,"description":"Habilitaciones sanitarias vigentes para exportar a la Unión Europea, por rubro."}},"nullable":true,"description":"Bloque unificado de comercio exterior. Null si la empresa no registra operaciones."},"contratos_publicos":{"type":"object","properties":{"cantidad":{"type":"integer","description":"Cantidad de contrataciones con adjudicación confirmada."},"total_ars":{"type":"number"},"recientes":{"type":"array","items":{"type":"object","properties":{"organismo":{"type":"string","nullable":true},"fecha":{"type":"string","format":"date","nullable":true},"monto":{"type":"string","nullable":true},"moneda":{"type":"string","nullable":true},"descripcion":{"type":"string","nullable":true},"rol":{"type":"string","nullable":true,"description":"adjudicataria | oferente | desestimada | null = sin clasificar (participó del proceso)."}}}}}},"creditos_subsidiados":{"type":"object","properties":{"cantidad":{"type":"integer"}}},"sanciones":{"type":"array","items":{"type":"object","properties":{"fecha":{"type":"string","format":"date"},"titulo":{"type":"string","nullable":true}}},"description":"Sanciones administrativas publicadas (UIF/CNV/BCRA)."},"apoc":{"type":"object","properties":{"fecha_condicion":{"type":"string","format":"date","nullable":true},"fecha_publicacion":{"type":"string","format":"date","nullable":true}},"nullable":true,"description":"Presencia en la base APOC de ARCA (facturas apócrifas). Dato informativo/preventivo. Null si no figura."},"sanciones_laborales_repsal":{"type":"array","items":{"type":"object","properties":{"tipo_infraccion":{"type":"string"},"organismo_sancionador":{"type":"string","nullable":true},"fecha_ingreso":{"type":"string","format":"date","nullable":true},"fin_publicacion":{"type":"string","format":"date","nullable":true},"numero_expediente":{"type":"string"}}},"description":"Sanciones vigentes en el REPSAL (Registro Público de Empleadores con Sanciones Laborales)."},"beneficiarios":{"type":"object","properties":{"umbral_pct":{"type":"number","description":"Umbral de referencia (10%, RG 4697 / UIF)."},"profundidad_maxima":{"type":"integer"},"metodologia":{"type":"string"},"personas":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"nombre_completo":{"type":"string"},"funcionario_publico":{"type":"boolean"},"participacion_directa_pct":{"type":"number","nullable":true,"description":"% directo cuando la persona es socia inmediata; null si sólo llega por cadena."},"participacion_efectiva_pct":{"type":"number","nullable":true,"description":"Suma de los caminos cuantificables (directo + indirecto multiplicado)."},"es_beneficiario_estimado":{"type":"boolean"},"caminos_sin_porcentaje":{"type":"integer","description":"Caminos societarios detectados cuyo % no fue publicado."},"cadena":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"participacion_pct":{"type":"number","nullable":true}}},"description":"Sociedades intermedias del camino cuantificado de mayor peso (vacía = directa)."},"fecha_ultimo_acto":{"type":"string","format":"date","nullable":true}}}}},"description":"Beneficiarios finales ESTIMADOS por actos registrales publicados. Sólo presente con campos=beneficiarios."},"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"}}}},"/busqueda":{"get":{"operationId":"busqueda","summary":"Búsqueda de empresas con filtros combinables.","description":"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 y los sellos booleanos (importador, exportador, empleador, contratista del Estado, deuda BCRA…). 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.\n\nCosto: 1 crédito por página.","parameters":[{"name":"q","in":"query","description":"Búsqueda textual por razón social.","schema":{"type":"string"}},{"name":"forma_legal","in":"query","description":"Forma legal.","schema":{"type":"string","enum":["sa","srl","sas","sca","scs","sociedad_colectiva","cooperativa","fundacion","asociacion_civil","mutual","ute","fideicomiso","sucursal_extranjera","other","sociedad_capital_industria","sociedad_estado","sociedad_hecho","sociedad_seccion_iv","federacion","camara","religiosa","agrupacion_colaboracion","consorcio_cooperacion","consorcio_ph","sgr","capitalizacion_ahorro","sucursal_nacional","persona_humana","profesional_matriculado"],"example":"sas"}},{"name":"jurisdiccion","in":"query","description":"Provincia o Ciudad Autónoma de Buenos Aires.","schema":{"type":"string","example":"Córdoba"}},{"name":"ciudad","in":"query","description":"Ciudad o localidad.","schema":{"type":"string"}},{"name":"actividad","in":"query","description":"Código de actividad AFIP (el de `actividad.codigo`).","schema":{"type":"string","example":"620100"}},{"name":"estado_fiscal","in":"query","description":"Estado ante ARCA.","schema":{"type":"string","enum":["activa","inactiva","baja","suspendida","unknown"]}},{"name":"capital","in":"query","description":"Rango de capital del último balance publicado (excluye empresas sin balance). lt-1m = Menos de $1M, 1m-10m = $1M a $10M, 10m-100m = $10M a $100M, gt-100m = Más de $100M.","schema":{"type":"string","enum":["lt-1m","1m-10m","10m-100m","gt-100m"]}},{"name":"importador","in":"query","description":"true = solo empresas con el sello \"Importadora\". Con despachos de importación registrados a su CUIT.","schema":{"type":"boolean"}},{"name":"exportador","in":"query","description":"true = solo empresas con el sello \"Exportadora\". Con exportaciones registradas o habilitación de exportador.","schema":{"type":"boolean"}},{"name":"empleador","in":"query","description":"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.","schema":{"type":"boolean"}},{"name":"contratista","in":"query","description":"true = solo empresas con el sello \"Contratista del Estado\". Con contratos u órdenes de compra del Estado adjudicados (no cuenta ofertas sin adjudicación).","schema":{"type":"boolean"}},{"name":"deuda_bcra","in":"query","description":"true = solo empresas con el sello \"Con deuda BCRA\". Con deuda informada por alguna entidad en la central de deudores del BCRA.","schema":{"type":"boolean"}},{"name":"cheque_rechazado","in":"query","description":"true = solo empresas con el sello \"Con cheques rechazados\". Con cheques rechazados informados por el BCRA.","schema":{"type":"boolean"}},{"name":"concurso_quiebra","in":"query","description":"true = solo empresas con el sello \"En concurso o quiebra\". Con concurso preventivo o quiebra publicados en boletines oficiales.","schema":{"type":"boolean"}},{"name":"sancionada","in":"query","description":"true = solo empresas con el sello \"Sancionada (UIF/CNV/BCRA)\". Con sanciones administrativas publicadas.","schema":{"type":"boolean"}},{"name":"apoc","in":"query","description":"true = solo empresas con el sello \"En base APOC\". Incluida en la base APOC de ARCA (facturas apócrifas).","schema":{"type":"boolean"}},{"name":"repsal","in":"query","description":"true = solo empresas con el sello \"Sanciones laborales (REPSAL)\". Con sanciones vigentes en el Registro Público de Empleadores con Sanciones Laborales.","schema":{"type":"boolean"}},{"name":"pep","in":"query","description":"true = solo empresas con el sello \"Vinculada a funcionario (PEP)\". Con al menos un dirigente identificado como persona expuesta políticamente.","schema":{"type":"boolean"}},{"name":"pagina","in":"query","description":"Página (1-400). Fuera de rango se ajusta al máximo, no da error.","schema":{"type":"integer","default":1,"maximum":400}}],"responses":{"200":{"description":"Búsqueda de empresas con filtros combinables.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Total real de resultados del filtro, aunque no sea todo navegable."},"pagina":{"type":"integer"},"por_pagina":{"type":"integer"},"total_paginas":{"type":"integer"},"resultados":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"forma_legal":{"type":"string","nullable":true},"jurisdiccion":{"type":"string","nullable":true},"ciudad":{"type":"string","nullable":true},"actividad":{"type":"object","properties":{"codigo":{"type":"string","nullable":true},"nombre":{"type":"string","nullable":true}}},"fecha_constitucion":{"type":"string","format":"date","nullable":true},"capital_ultimo_balance":{"type":"string","nullable":true},"estado_fiscal":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"402":{"$ref":"#/components/responses/SinCreditos"},"429":{"$ref":"#/components/responses/RateLimit"}}}},"/busqueda-personas":{"get":{"operationId":"busqueda-personas","summary":"Búsqueda de dirigentes y socios por nombre.","description":"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.\n\nCosto: 1 crédito por página.","parameters":[{"name":"q","in":"query","required":true,"description":"Nombre a buscar (mínimo 3 caracteres).","schema":{"type":"string","example":"perez garcia"}},{"name":"pagina","in":"query","description":"Página (1-50). Fuera de rango se ajusta al máximo, no da error.","schema":{"type":"integer","default":1,"maximum":50}}],"responses":{"200":{"description":"Búsqueda de dirigentes y socios por nombre.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Total real de resultados del filtro, aunque no sea todo navegable."},"pagina":{"type":"integer"},"por_pagina":{"type":"integer"},"resultados":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"nombre_completo":{"type":"string"},"funcionario_publico":{"type":"boolean"},"empresas":{"type":"integer","description":"Cantidad de empresas vinculadas."}}}}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"402":{"$ref":"#/components/responses/SinCreditos"},"429":{"$ref":"#/components/responses/RateLimit"}}}},"/persona":{"get":{"operationId":"persona","summary":"Ficha de una persona por CUIT.","description":"Identidad de la persona, su condición fiscal AFIP (monotributo/responsable inscripto/autónomo, categoría y actividad declarada cuando es actor económico), todas sus empresas vinculadas con los roles que ocupa y su riesgo crediticio BCRA cuando la identidad del CUIT está corroborada.\n\nCosto: 1 crédito.","parameters":[{"name":"cuit","in":"query","required":true,"description":"CUIT/CUIL de la persona (11 dígitos, con o sin guiones).","schema":{"type":"string","example":"30500010912"}}],"responses":{"200":{"description":"Ficha de una persona por CUIT.","content":{"application/json":{"schema":{"type":"object","properties":{"cuit":{"type":"string"},"nombre_completo":{"type":"string"},"funcionario_publico":{"type":"boolean"},"fiscal":{"type":"object","properties":{"condicion":{"type":"string","nullable":true,"description":"monotributo, responsable_inscripto, autonomo, con_actividad…"},"monotributo_categoria":{"type":"string","nullable":true},"actividad":{"type":"string","nullable":true},"estado":{"type":"string","nullable":true,"description":"activa | inactiva | unknown"}},"nullable":true,"description":"Condición fiscal AFIP (padrón A13). Null cuando la persona no es un actor económico."},"empresas":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"forma_legal":{"type":"string","nullable":true},"jurisdiccion":{"type":"string","nullable":true},"roles":{"type":"array","items":{"type":"string"}}}},"description":"Empresas vinculadas con los roles que ocupa en cada una."},"deudas_bcra":{"type":"object","properties":{"periodo":{"type":"string","description":"Período informado (AAAAMM)."},"peor_situacion":{"type":"integer","description":"1 = normal … 5 = irrecuperable."},"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)."}},"nullable":true,"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","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","nullable":true},"pagado":{"type":"boolean"},"fecha_pago":{"type":"string","format":"date","nullable":true}}},"description":"Últimos cheques rechazados, uno por uno (hasta 50, más recientes primero)."}},"nullable":true,"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"}}}},"/llamados":{"get":{"operationId":"llamados","summary":"Búsqueda de llamados a licitación del Estado.","description":"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.\n\nCosto: 1 crédito por página.","parameters":[{"name":"q","in":"query","description":"Búsqueda textual por organismo, objeto, rubro o procedimiento.","schema":{"type":"string"}},{"name":"rubro","in":"query","description":"Categoría del llamado.","schema":{"type":"string","enum":["suministros","servicios","obras","locaciones"]}},{"name":"organismo","in":"query","description":"Slug del organismo convocante (el de `organismo_slug` en los resultados).","schema":{"type":"string"}},{"name":"abiertas","in":"query","description":"true = solo llamados con fecha de apertura de ofertas futura.","schema":{"type":"boolean"}},{"name":"pagina","in":"query","description":"Página (1-500). Fuera de rango se ajusta al máximo, no da error.","schema":{"type":"integer","default":1,"maximum":500}}],"responses":{"200":{"description":"Búsqueda de llamados a licitación del Estado.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Total real de resultados del filtro, aunque no sea todo navegable."},"pagina":{"type":"integer"},"por_pagina":{"type":"integer"},"total_paginas":{"type":"integer"},"resultados":{"type":"array","items":{"type":"object","properties":{"organismo":{"type":"string"},"organismo_slug":{"type":"string","nullable":true},"procedimiento":{"type":"string","nullable":true},"rubro":{"type":"string","nullable":true,"description":"Categoría y subrubro del boletín (ej: SUMINISTROS - EFECTOS VARIOS)."},"objeto":{"type":"string","nullable":true},"expediente":{"type":"string","nullable":true},"fecha_apertura":{"type":"string","format":"date-time","nullable":true,"description":"Fecha y hora (ART) de apertura de ofertas."},"fecha_publicacion":{"type":"string","format":"date"},"fuente":{"type":"string","nullable":true,"description":"Boletín oficial de origen."},"url_ficha":{"type":"string","nullable":true}}}}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"402":{"$ref":"#/components/responses/SinCreditos"},"429":{"$ref":"#/components/responses/RateLimit"}}}},"/importadores":{"get":{"operationId":"importadores","summary":"Ranking de empresas importadoras con filtros.","description":"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.\n\nCosto: 1 crédito por página.","parameters":[{"name":"ncm","in":"query","description":"Prefijo de posición NCM: capítulo (84), partida (8471) o posición completa.","schema":{"type":"string","example":"8471"}},{"name":"pais","in":"query","description":"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.","schema":{"type":"string","example":"CN"}},{"name":"jurisdiccion","in":"query","description":"Provincia o Ciudad Autónoma de Buenos Aires de la empresa.","schema":{"type":"string"}},{"name":"actividad","in":"query","description":"Código de actividad AFIP de la empresa (el de `actividad.codigo`).","schema":{"type":"string","example":"620100"}},{"name":"desde","in":"query","description":"Período inicial AAAAMM (default 11 meses antes de `hasta`).","schema":{"type":"string","example":"202501"}},{"name":"hasta","in":"query","description":"Período final AAAAMM (default el último mes con datos).","schema":{"type":"string","example":"202607"}},{"name":"pagina","in":"query","description":"Página (1-250). Fuera de rango se ajusta al máximo, no da error.","schema":{"type":"integer","default":1,"maximum":250}}],"responses":{"200":{"description":"Ranking de empresas importadoras con filtros.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Total real de resultados del filtro, aunque no sea todo navegable."},"pagina":{"type":"integer"},"por_pagina":{"type":"integer"},"total_paginas":{"type":"integer"},"periodo_desde":{"type":"string","description":"Ventana AAAAMM efectivamente consultada."},"periodo_hasta":{"type":"string"},"resultados":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"jurisdiccion":{"type":"string","nullable":true},"fob_usd":{"type":"number"},"cif_usd_estimado":{"type":"number","nullable":true,"description":"ESTIMADO, no declarado. Null cuando la estimación no cubre suficiente FOB del importador en el período."},"flete_y_seguro_usd_estimado":{"type":"number","nullable":true,"description":"ESTIMADO. Flete MÁS seguro; no se pueden separar."},"cobertura_cif_pct":{"type":"number","description":"Porcentaje del FOB del importador con valor CIF estimado."},"tributos_totales_usd":{"type":"number","nullable":true,"description":"Tributos efectivamente liquidados (declarados)."},"kilos":{"type":"number","nullable":true,"description":"Peso neto sólo de las operaciones cuya unidad estadística lo mide."},"despachos":{"type":"integer"},"items":{"type":"integer"},"meses_con_operaciones":{"type":"integer"},"posiciones_ncm":{"type":"integer"},"paises_origen":{"type":"integer"},"url_ficha":{"type":"string"}}}}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"402":{"$ref":"#/components/responses/SinCreditos"},"429":{"$ref":"#/components/responses/RateLimit"}}}},"/sugerencias":{"get":{"operationId":"sugerencias","summary":"Autocomplete de empresas (gratis).","description":"Hasta 8 empresas que matchean un texto parcial, pensado para autocompletar formularios. Gratis, con cupo de 1.000 consultas por día.\n\nCosto: gratis.","parameters":[{"name":"q","in":"query","required":true,"description":"Texto parcial (mínimo 2 caracteres).","schema":{"type":"string","example":"mercado"}}],"responses":{"200":{"description":"Autocomplete de empresas (gratis).","content":{"application/json":{"schema":{"type":"object","properties":{"resultados":{"type":"array","items":{"type":"object","properties":{"cuit":{"type":"string"},"razon_social":{"type":"string"},"jurisdiccion":{"type":"string","nullable":true}}}}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"429":{"$ref":"#/components/responses/RateLimit"}}}},"/creditos":{"get":{"operationId":"creditos","summary":"Saldo y consumo de créditos (gratis).","description":"Créditos disponibles de tu cuenta y consumo del mes en curso.\n\nCosto: gratis.","responses":{"200":{"description":"Saldo y consumo de créditos (gratis).","content":{"application/json":{"schema":{"type":"object","properties":{"creditos_disponibles":{"type":"integer"},"consumidos_este_mes":{"type":"integer"}}}}}},"400":{"$ref":"#/components/responses/ParametroInvalido"},"401":{"$ref":"#/components/responses/NoAutorizado"},"429":{"$ref":"#/components/responses/RateLimit"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"api-key","in":"header","description":"API key creada en https://indicadores.ar/api-empresas"}},"responses":{"ParametroInvalido":{"description":"Parámetro inválido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NoAutorizado":{"description":"API key faltante o inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SinCreditos":{"description":"Créditos insuficientes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NoEncontrado":{"description":"No encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimit":{"description":"Límite de requests excedido.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}