Skip to main content
GET
/
transparency
/
biddings
Listar licitações
curl --request GET \
  --url https://api.startgov.com.br/v1/transparency/biddings
{
  "success": true,
  "message": "Dados recuperados com sucesso",
  "data": {
    "current_page": 1,
    "per_page": 20,
    "total": 150,
    "last_page": 8,
    "from": 1,
    "to": 20,
    "data": [
      {
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "number": "001/2024",
        "budget_secret": false,
        "modality": "Pregão Eletrônico",
        "register_price": true,
        "company_name": "Prefeitura Municipal de Exemplo",
        "company_name_short": "PME",
        "opening_date": "2023-11-07T05:31:56Z",
        "status": "Homologado",
        "object_details": "Aquisição de material de escritório",
        "sum_amount_total": "50000.00",
        "sum_amount_total_finish": "48500.00",
        "precision": 2
      }
    ]
  }
}

Query Parameters

​
organization_uuid
string<uuid>
required

UUID da organização

​
bidding_number
string

Número exato da licitação

​
date_from
string<date>

Data inicial do filtro (YYYY-MM-DD). Deve ser usado em conjunto com date_to.

Example:

"2024-01-01"

​
date_to
string<date>

Data final do filtro (YYYY-MM-DD). Deve ser usado em conjunto com date_from.

Example:

"2024-12-31"

​
typeDateFilter
enum<string>

Campo de data usado no filtro de intervalo

Available options:
open,
publication
​
bidding_modality_id
integer

ID da modalidade licitatória. Use /transparency/biddingModalities para obter os IDs disponíveis.

​
bidding_status_id
integer

ID do status da licitação. Use /transparency/biddingStatuses para obter os IDs disponíveis.

​
search
string

Busca textual no objeto e número do processo

​
year
integer

Filtro por ano do exercício

Example:

2024

​
per_page
integer
default:20

Número de registros por página. Mínimo: 1. Máximo: 100.

Required range: 1 <= x <= 100
​
with_relations
string

Relações a incluir na resposta, separadas por vírgula. Valores aceitos: documents, contracts, arps, providers.

Example:

"documents,contracts,arps"

Response

200 - application/json

Lista paginada de licitações

​
success
boolean
Example:

true

​
message
string
Example:

"Dados recuperados com sucesso"

​
data
object