Buscar Items

curl "https://api.ata360.com.br/api/items?uf=SP&vigente=true&source=ata&limit=10" \
  -H "Authorization: Bearer ak_sua_chave"

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())

{
  "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
  }
}

GET

api

items

curl "https://api.ata360.com.br/api/items?uf=SP&vigente=true&source=ata&limit=10" \
  -H "Authorization: Bearer ak_sua_chave"

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())

{
  "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
  }
}

Parametros

number

default:"1"

Numero da pagina

number

default:"20"

Quantidade por pagina (max 100)

string

Fonte dos items: ata ou contrato

string

Sistema de origem: pncp ou comprasgov

string

Sigla do estado (2 letras)

string

Nome do municipio (min 2 caracteres)

number

Codigo CATMAT/CATSER

string

CNPJ do fornecedor

string

Nome do fornecedor (min 2 caracteres)

string

Porte do fornecedor

string

Classificacao: ME, EPP, MEDIO, GRANDE

string

CNPJ do orgao comprador

string

Nome do orgao (min 2 caracteres)

number

Codigo da UASG

string

Nome da UASG (min 2 caracteres)

string

Busca por descricao (min 3 caracteres)

boolean

Filtrar apenas items vigentes

number

Valor unitario minimo

number

Valor unitario maximo

string

Filtrar por modalidade de licitacao

string

Data inicio do periodo (YYYY-MM-DD)

string

Data fim do periodo (YYYY-MM-DD)

Resposta

array

Lista de items

Show Propriedades

string

ID unico do item

string

Fonte: ata ou contrato

string

Sistema: pncp ou comprasgov

string

Numero do item

number

Codigo CATMAT/CATSER

string

Descricao do item

string

MATERIAL ou SERVICO

number

Valor unitario

number

Valor total

number

Quantidade

string

CNPJ do fornecedor

string

Nome do fornecedor

string

Porte do fornecedor

number

Codigo UASG

string

Nome UASG

string

Estado

string

Municipio

string

Nome do orgao

string

Modalidade

string

Controle PNCP (ATA)

string

Controle PNCP (Contrato)

string

Inicio vigencia

string

Fim vigencia

string

Unidade de medida

string

Tipo material/servico

string

Codigo NCM

string

Descricao NCM

string

Situacao do item

string

Criterio de julgamento

string

Tipo de beneficio

number

Valor estimado

boolean

Se tem resultado publicado

string

Descricao detalhada

object

Informacoes de paginacao

curl "https://api.ata360.com.br/api/items?uf=SP&vigente=true&source=ata&limit=10" \
  -H "Authorization: Bearer ak_sua_chave"

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())

{
  "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
  }
}

Visão geral

Consultas principais

Parametros

Resposta