> ## 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.

# Buscar Items

> Busca e filtra items de ATAs e Contratos

## 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" type="string">
  Fonte dos items: `ata` ou `contrato`
</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="municipio" type="string">
  Nome do municipio (min 2 caracteres)
</ParamField>

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

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

<ParamField query="nome_fornecedor" type="string">
  Nome do fornecedor (min 2 caracteres)
</ParamField>

<ParamField query="porte_fornecedor" type="string">
  Porte do fornecedor
</ParamField>

<ParamField query="classificacao_fornecedor" type="string">
  Classificacao: ME, EPP, MEDIO, GRANDE
</ParamField>

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

<ParamField query="nome_orgao" type="string">
  Nome do orgao (min 2 caracteres)
</ParamField>

<ParamField query="codigo_uasg" type="number">
  Codigo da UASG
</ParamField>

<ParamField query="nome_uasg" type="string">
  Nome da UASG (min 2 caracteres)
</ParamField>

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

<ParamField query="vigente" type="boolean">
  Filtrar apenas items vigentes
</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>

<ParamField query="data_inicio" type="string">
  Data inicio do periodo (YYYY-MM-DD)
</ParamField>

<ParamField query="data_fim" type="string">
  Data fim do periodo (YYYY-MM-DD)
</ParamField>

## Resposta

<ResponseField name="data" type="array">
  Lista de items

  <Expandable title="Propriedades">
    <ResponseField name="id_item" type="string">ID unico do item</ResponseField>
    <ResponseField name="source" type="string">Fonte: ata ou contrato</ResponseField>
    <ResponseField name="source_system" type="string">Sistema: pncp ou comprasgov</ResponseField>
    <ResponseField name="numero_item" type="string">Numero do item</ResponseField>
    <ResponseField name="codigo_item" type="number">Codigo CATMAT/CATSER</ResponseField>
    <ResponseField name="descricao_item" type="string">Descricao do item</ResponseField>
    <ResponseField name="tipo_item" type="string">MATERIAL ou SERVICO</ResponseField>
    <ResponseField name="valor_unitario" type="number">Valor unitario</ResponseField>
    <ResponseField name="valor_total" type="number">Valor total</ResponseField>
    <ResponseField name="quantidade" type="number">Quantidade</ResponseField>
    <ResponseField name="cnpj_fornecedor" type="string">CNPJ do fornecedor</ResponseField>
    <ResponseField name="nome_fornecedor" type="string">Nome do fornecedor</ResponseField>
    <ResponseField name="porte_fornecedor" type="string">Porte do fornecedor</ResponseField>
    <ResponseField name="codigo_uasg" type="number">Codigo UASG</ResponseField>
    <ResponseField name="nome_uasg" type="string">Nome UASG</ResponseField>
    <ResponseField name="uf" type="string">Estado</ResponseField>
    <ResponseField name="municipio" type="string">Municipio</ResponseField>
    <ResponseField name="nome_orgao" type="string">Nome do orgao</ResponseField>
    <ResponseField name="nome_modalidade" type="string">Modalidade</ResponseField>
    <ResponseField name="numero_controle_pncp_ata" type="string">Controle PNCP (ATA)</ResponseField>
    <ResponseField name="numero_controle_pncp_contrato" type="string">Controle PNCP (Contrato)</ResponseField>
    <ResponseField name="data_vigencia_inicial" type="string">Inicio vigencia</ResponseField>
    <ResponseField name="data_vigencia_final" type="string">Fim vigencia</ResponseField>
    <ResponseField name="unidade_medida" type="string">Unidade de medida</ResponseField>
    <ResponseField name="material_ou_servico" type="string">Tipo material/servico</ResponseField>
    <ResponseField name="ncm_codigo" type="string">Codigo NCM</ResponseField>
    <ResponseField name="ncm_descricao" type="string">Descricao NCM</ResponseField>
    <ResponseField name="situacao_item" type="string">Situacao do item</ResponseField>
    <ResponseField name="criterio_julgamento" type="string">Criterio de julgamento</ResponseField>
    <ResponseField name="tipo_beneficio" type="string">Tipo de beneficio</ResponseField>
    <ResponseField name="valor_estimado" type="number">Valor estimado</ResponseField>
    <ResponseField name="tem_resultado" type="boolean">Se tem resultado publicado</ResponseField>
    <ResponseField name="descricao_detalhada" type="string">Descricao detalhada</ResponseField>
  </Expandable>
</ResponseField>

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

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

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

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id_item": "ata_123_1",
        "source": "ata",
        "source_system": "comprasgov",
        "numero_item": "1",
        "codigo_item": 453789,
        "descricao_item": "PAPEL A4 BRANCO 75G/M2",
        "tipo_item": "MATERIAL",
        "valor_unitario": 25.50,
        "valor_total": 12750.00,
        "quantidade": 500,
        "cnpj_fornecedor": "12345678000199",
        "nome_fornecedor": "PAPELARIA LTDA",
        "porte_fornecedor": "ME",
        "codigo_uasg": 150233,
        "nome_uasg": "HOSPITAL DAS CLINICAS",
        "uf": "SP",
        "municipio": "SAO PAULO",
        "nome_orgao": "MINISTERIO DA SAUDE",
        "nome_modalidade": "Pregao Eletronico",
        "numero_controle_pncp_ata": "00394544000143-1-000001/2025-000001",
        "numero_controle_pncp_contrato": "",
        "data_vigencia_inicial": "2025-01-15",
        "data_vigencia_final": "2026-01-15",
        "unidade_medida": "RESMA",
        "ncm_codigo": "48025610",
        "situacao_item": "Homologado",
        "criterio_julgamento": "Menor Preco"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 1500,
      "totalPages": 150
    }
  }
  ```
</ResponseExample>
