Indicadores Argentina Llamados API

openapi: 3.2.0
info:
  title: Indicadores Ar Llamados API
  version: '1.1'
  contact:
    email: contacto@indicadores.ar
    url: https://indicadores.ar/api-empresas
  description: 'Operations tagged Llamados 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: Llamados
paths:
  /llamados:
    get:
      operationId: llamados
      summary: Búsqueda de llamados a licitación del Estado, una fila por proceso
      description: 'Llamados a licitación y contrataciones públicas detectados en los boletines oficiales nacionales y provinciales: organismo, objeto, rubro, expediente, fecha de apertura de ofertas y link para participar. Devuelve una fila por PROCESO: las circulares, prórrogas y aclaraciones del mismo proceso no son llamados nuevos, son su historial (en /llamado), y lo que una actualización cambia (la apertura, el link) es lo que vale. Ordenado por la última publicación del proceso. Todos los parámetros son opcionales y se combinan; sin filtros devuelve los procesos con novedades más recientes. `organismos` y `palabras` arman el recorte de una alerta: los procesos de esos organismos O con esas palabras en el objeto.


        Costo: 1 crédito por página.'
      parameters:
      - name: q
        in: query
        description: Búsqueda textual por organismo, objeto, rubro o procedimiento (todas las palabras). Un DNI o un CUIT/CUIL de persona humana es un 400 `busqueda_de_documento`.
        schema:
          type: string
      - name: jurisdiccion
        in: query
        description: 'Jurisdicción que convoca: `nacional` (Boletín Oficial de la Nación), `caba`, `pba` o la provincia. Uno o varios separados por coma. Acepta también el nombre (Buenos Aires, Santa Fe, CABA, Capital Federal, sin tildes ni mayúsculas); un valor que no es ninguno es un 400 `jurisdiccion_invalida` con la lista. Valores canónicos: nacional, caba, pba, catamarca, chaco, chubut, cordoba, corrientes, entrerios, formosa, jujuy, lapampa, larioja, mendoza, misiones, neuquen, rionegro, salta, sanjuan, sanluis, santacruz, santafe, sde, tierradelfuego, tucuman.'
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          example:
          - nacional
          - caba
          - pba
      - name: nivel
        in: query
        description: 'Nivel de gobierno que convoca: `nacional`, `provincial` o `municipal`. Uno o varios separados por coma. Es el gobierno que contrata, no el boletín: un llamado de una municipalidad publicado en el Boletín de la Provincia de Buenos Aires es `municipal` y su `jurisdiccion` es `pba`. La Ciudad de Buenos Aires cuenta como `provincial`. Un valor que no es ninguno es un 400 `nivel_invalido` con la lista.'
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - nacional
            - provincial
            - municipal
          example:
          - municipal
      - name: organismos
        in: query
        description: 'Hasta 30 organismos convocantes (su `organismo_slug`), separados por coma. Se suman a `palabras`: entra el proceso que es de uno de estos organismos O tiene una de las palabras. Un slug sin ningún llamado es un 400 `organismo_invalido` que los nombra en `organismos_sin_llamados`.'
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          example:
          - ministerio-de-salud
          - hospital-de-pediatria-s-a-m-i-c-prof-dr-juan-p-garrahan
      - name: palabras
        in: query
        description: 'Hasta 30 palabras clave separadas por coma, buscadas en el objeto del llamado sin acentos ni mayúsculas (el mismo criterio que la alerta por palabra clave de la web). Basta con una. Cada una tiene de 3 a 60 caracteres: letras, números, espacios, puntos o guiones; otra cosa es un 400 `palabra_invalida`, y un DNI o un CUIT/CUIL de persona humana, un 400 `busqueda_de_documento`.'
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
          example:
          - medicamentos
          - insumos medicos
          - reactivos
      - name: desde
        in: query
        description: Sólo los procesos con alguna publicación desde esa fecha inclusive (el llamado o una actualización). Fecha AAAA-MM-DD; otra cosa es un 400 `desde_invalido`.
        schema:
          type: string
          example: '2026-09-01'
      - name: rubro
        in: query
        description: Categoría del llamado. Un valor fuera de la lista es un 400 `rubro_invalido`.
        schema:
          type: string
          enum:
          - suministros
          - servicios
          - obras
          - locaciones
      - name: organismo
        in: query
        description: Un solo organismo convocante (su `organismo_slug`), en AND con el resto. Un slug que no corresponde a ningún organismo con llamados es un 400 `organismo_invalido`.
        schema:
          type: string
      - name: abiertas
        in: query
        description: true = sólo procesos cuya última fecha de apertura de ofertas informada todavía no llegó (a la hora de Buenos Aires; sin hora, vale todo ese día).
        schema:
          type: boolean
      - name: pagina
        in: query
        description: Página (1-500). 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: 500
      responses:
        '200':
          description: Búsqueda de llamados a licitación del Estado, una fila por proceso.
          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:
                        slug:
                          type:
                          - string
                          - 'null'
                          description: 'Identificador del proceso: el de su primera publicación. Se pasa a /llamado.'
                        numero_proceso:
                          type:
                          - string
                          - 'null'
                          description: 'Clave del proceso dentro del organismo: el número que imprime la plataforma de compras cuando el aviso lo trae (12-0188-LPU26) o el tipo y el número (licitacion-publica:74/2026). Null cuando el aviso no trae número: esa publicación es su propio proceso.'
                        organismo:
                          type: string
                        organismo_slug:
                          type:
                          - string
                          - 'null'
                        procedimiento:
                          type:
                          - string
                          - 'null'
                        rubro:
                          type:
                          - string
                          - 'null'
                          description: 'Categoría y subrubro del boletín (ej: SUMINISTROS - EFECTOS VARIOS).'
                        objeto:
                          type:
                          - string
                          - 'null'
                          description: El objeto del llamado, con los números de documento de personas humanas tapados (***).
                        expediente:
                          type:
                          - string
                          - 'null'
                        jurisdiccion:
                          type:
                          - string
                          - 'null'
                          enum:
                          - nacional
                          - caba
                          - pba
                          - catamarca
                          - chaco
                          - chubut
                          - cordoba
                          - corrientes
                          - entrerios
                          - formosa
                          - jujuy
                          - lapampa
                          - larioja
                          - mendoza
                          - misiones
                          - neuquen
                          - rionegro
                          - salta
                          - sanjuan
                          - sanluis
                          - santacruz
                          - santafe
                          - sde
                          - tierradelfuego
                          - tucuman
                          - null
                          description: Jurisdicción que convoca.
                        nivel:
                          type: string
                          enum:
                          - nacional
                          - provincial
                          - municipal
                          description: Nivel de gobierno que convoca.
                        fuente:
                          type:
                          - string
                          - 'null'
                          description: Boletín oficial de origen.
                        fecha_publicacion:
                          type: string
                          format: date
                          description: Primera publicación del proceso.
                        fecha_ultima_actualizacion:
                          type: string
                          format: date
                          description: Última publicación del proceso (una circular, una prórroga o el mismo llamado).
                        publicaciones:
                          type: integer
                          description: 'Cuántas veces se publicó el proceso: el llamado más sus actualizaciones.'
                        fecha_apertura:
                          type:
                          - string
                          - 'null'
                          format: date-time
                          description: Apertura de ofertas, la última informada. Fecha y hora de Buenos Aires con su zona (-03:00). Si el aviso no dice la hora, 00:00.
                        apertura_pendiente:
                          type:
                          - boolean
                          - 'null'
                          description: true si la apertura todavía no llegó; null si no hay fecha de apertura.
                        url_participacion:
                          type:
                          - string
                          - 'null'
                          description: El link para participar o retirar el pliego que publica el propio aviso.
                        url_ficha:
                          type:
                          - string
                          - 'null'
        '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:
      - Llamados
    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