> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ata360.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar ATAs

> Lista ATAs agregadas a partir dos itens no ClickHouse

## Parametros

<ParamField query="page" type="number" default="1">
  Numero da pagina
</ParamField>

<ParamField query="limit" type="number" default="20">
  Quantidade por pagina (max 100)
</ParamField>

<ParamField query="source_system" type="string">
  Sistema de origem: `pncp` ou `comprasgov`
</ParamField>

<ParamField query="uf" type="string">
  Sigla do estado (2 letras)
</ParamField>

<ParamField query="codigo_item" type="number">
  Codigo CATMAT/CATSER
</ParamField>

<ParamField query="cnpj_fornecedor" type="string">
  CNPJ do fornecedor
</ParamField>

<ParamField query="cnpj_orgao" type="string">
  CNPJ do orgao comprador
</ParamField>

<ParamField query="descricao" type="string">
  Busca por descricao do item (min 3 caracteres)
</ParamField>

<ParamField query="vigente" type="boolean">
  Filtrar apenas ATAs com vigencia ativa
</ParamField>

<ParamField query="valor_min" type="number">
  Valor unitario minimo
</ParamField>

<ParamField query="valor_max" type="number">
  Valor unitario maximo
</ParamField>

<ParamField query="modalidade" type="string">
  Filtrar por modalidade de licitacao
</ParamField>

## Resposta

<ResponseField name="data" type="array">
  Lista de ATAs agregadas

  <Expandable title="Propriedades">
    <ResponseField name="numero_controle_pncp_ata" type="string">
      Identificador unico da ATA no PNCP
    </ResponseField>

    <ResponseField name="nome_orgao" type="string">
      Nome do orgao responsavel
    </ResponseField>

    <ResponseField name="uf" type="string">
      Estado
    </ResponseField>

    <ResponseField name="municipio" type="string">
      Municipio
    </ResponseField>

    <ResponseField name="data_vigencia_inicial" type="string">
      Inicio da vigencia
    </ResponseField>

    <ResponseField name="data_vigencia_final" type="string">
      Fim da vigencia
    </ResponseField>

    <ResponseField name="nome_modalidade" type="string">
      Modalidade de licitacao
    </ResponseField>

    <ResponseField name="itens_count" type="number">
      Quantidade de itens na ATA
    </ResponseField>

    <ResponseField name="valor_min" type="number">
      Menor valor unitario entre os itens
    </ResponseField>

    <ResponseField name="valor_max" type="number">
      Maior valor unitario entre os itens
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Informacoes de paginacao
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.ata360.com.br/api/atas?uf=SP&vigente=true&limit=10" \
    -H "Authorization: Bearer ak_sua_chave"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.ata360.com.br/api/atas",
      params={"uf": "SP", "vigente": True, "limit": 10},
      headers={"Authorization": "Bearer ak_sua_chave"}
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "numero_controle_pncp_ata": "12345678000199-1-000001/2025-000001",
        "nome_orgao": "MINISTERIO DA SAUDE",
        "uf": "SP",
        "municipio": "SAO PAULO",
        "data_vigencia_inicial": "2025-01-15",
        "data_vigencia_final": "2026-01-15",
        "nome_modalidade": "Pregao Eletronico",
        "itens_count": 45,
        "valor_min": 1.50,
        "valor_max": 1250.00
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 532,
      "totalPages": 54
    }
  }
  ```
</ResponseExample>