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

> Busca paginada de ofertas com filtros e ordenação

<Note>Endpoint **público** — não exige autenticação.</Note>

Busca paginada de ofertas. Aceita filtros, ordenação e paginação no formato compartilhado do Marketplace.

## 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/offers/search \
    -H "Content-Type: application/json" \
    -d '{
      "page": { "number": 0, "size": 10 },
      "sort": [{ "field": "createdAt", "direction": "desc" }],
      "filters": { "and": [{ "field": "status", "operator": "eq", "value": "pending" }] }
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 200 - Ofertas (paginado, HATEOAS) theme={null}
  {
    "total": 1,
    "pageStart": 0,
    "pageSize": 10,
    "totalPages": 1,
    "_links": { "self": { "href": "/zipconsig-marketplace/offers/search?pageStart=0&pageSize=10" } },
    "_embedded": [
      {
        "_embedded": {
          "id": 4521,
          "cpf": "52998224725",
          "offerer": true,
          "loanValue": 10000.00,
          "installmentsNumber": 36,
          "employer": "Empresa ABC",
          "status": "pending",
          "hasGuarantee": "false"
        },
        "_links": { "self": { "href": "/zipconsig-marketplace/offers/4521" } }
      }
    ]
  }
  ```
</ResponseExample>