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

# Buscar leilões

> Consulta o andamento e o resultado dos leilões de crédito

É aqui que a Zipdin executa a competição entre as ofertas recebidas para uma solicitação e define o parceiro
vencedor. Esta chamada permite consultar o andamento e o resultado dos leilões.

<Info>
  Todos os endpoints requerem autenticação via **Bearer token** no header `Authorization`.
  Consulte o [guia de autenticação](/docs/primeiros-passos/authentication) para obter suas credenciais e gerar um token.
</Info>

## Parâmetros

<ParamField body="page.number" type="integer">
  Número da página, começando em 0 (padrão: `0`)
</ParamField>

<ParamField body="page.size" type="integer">
  Itens por página — de 5 a 100 (padrão: `10`)
</ParamField>

<ParamField body="sort" type="array">
  Array de `{field, direction}` (`direction`: `asc` ou `desc`)
</ParamField>

<ParamField body="filters" type="object">
  Objeto com chaves `and` / `or` / `not`, cada uma um array de `{field, operator, value}`. Operadores
  aceitos: `eq`, `ne`, `lte`, `gte`, `lt`, `gt`, `startswith`, `between`, `like`, `ilike`, `in`, `notIn`,
  `isNull`.
</ParamField>

## Exemplo

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://hml.zipdin.com.br/zipconsig-marketplace/auctions/search \
    -H "Authorization: Bearer SEU_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "page": { "number": 0, "size": 10 },
      "filters": { "and": [{ "field": "status", "operator": "eq", "value": "open" }] }
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 200 - Leilões (paginado, HATEOAS) theme={null}
  {
    "total": 1,
    "pageStart": 0,
    "pageSize": 10,
    "totalPages": 1,
    "_embedded": [
      {
        "_embedded": {
          "id": 8871,
          "cpf": "52998224725",
          "startDate": "2026-05-20T10:00:00.000Z",
          "durationSeconds": 300,
          "auctionValidityDateTime": "2026-05-20T10:05:00.000Z",
          "winningOfferIds": [4521],
          "status": "closed",
          "guarantee": false
        },
        "_links": { "self": { "href": "/zipconsig-marketplace/auctions/8871" } }
      }
    ]
  }
  ```
</ResponseExample>

## Campos de resposta

| Campo                     | Descrição                                         |
| ------------------------- | ------------------------------------------------- |
| `id`                      | ID do leilão                                      |
| `cpf`                     | CPF do trabalhador da solicitação em leilão       |
| `startDate`               | Início do leilão                                  |
| `durationSeconds`         | Duração da janela de leilão, em segundos          |
| `auctionValidityDateTime` | Até quando o resultado do leilão é válido         |
| `winningOfferIds`         | IDs das ofertas vencedoras (pode ter mais de uma) |
| `status`                  | Status do leilão                                  |
| `guarantee`               | Se o leilão é da modalidade com garantia          |

## Próximo passo

Consulte a oferta vencedora em [Consultar oferta](/docs/marketplace/consultar-oferta) e averbe em
[Averbar oferta](/docs/marketplace/averbar-oferta).