Indicadores Argentina Busqueda Personas API

openapi: 3.2.0
info:
  title: Indicadores Ar Busqueda Personas API
  version: '1.1'
  contact:
    email: contacto@indicadores.ar
    url: https://indicadores.ar/api-empresas
  description: 'Operations tagged Busqueda Personas across 2 of this provider''s published API definitions: indicadores-ar-openapi.json, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://indicadores.ar/v1
security:
- apiKey: []
tags:
- name: Busqueda Personas
paths:
  /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 `persona_id` o con el CUIT.


        Costo: 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. Con sólo los créditos gratis de bienvenida, de la 4 en adelante es 402 `pagina_requiere_creditos_comprados`, sin cobro.
        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:
                        persona_id:
                          type: integer
                          description: 'Id de la persona: su ficha es `/persona?id=`, sin usar el documento.'
                        cuit:
                          type: string
                        nombre_completo:
                          type: string
                        funcionario_publico:
                          type: boolean
                          description: Declaró como funcionario/a ante la Oficina Anticorrupción en algún año; no implica que lo sea hoy.
                        funcionario_publico_anio:
                          type:
                          - integer
                          - 'null'
                          description: Año de su última declaración jurada; null si no declaró.
                        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'
        '500':
          $ref: '#/components/responses/ErrorInterno'
        '503':
          $ref: '#/components/responses/NoDisponible'
      tags:
      - Busqueda Personas
    servers:
    - url: https://indicadores.ar/v1
components:
  responses:
    RateLimit:
      description: limite_de_requests_excedido (por minuto), limite_diario_gratuito_excedido (endpoints gratis) o limite_diario_autoservicio_excedido (cupo diario de créditos por cuenta).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NoAutorizado:
      description: api_key_faltante, api_key_malformada (la key llegó cortada o con otro formato) o api_key_invalida (no existe o fue revocada).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    SinCreditos:
      description: Créditos insuficientes.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ParametroInvalido:
      description: Parámetro inválido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ErrorInterno:
      description: error_interno. Reintentar; no se cobra.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NoDisponible:
      description: servicio_no_disponible (transitorio, con Retry-After) o padron_no_disponible (el CUIT no está en nuestro padrón y el padrón fiscal no respondió a tiempo) o consulta_demorada (la búsqueda superó su tope de tiempo). Reintentar; no se cobra.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      name: api-key
      in: header
      description: API key creada en https://indicadores.ar/api-empresas
x-refined-from:
- indicadores-ar-openapi.json
- openapi.json