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

# Paginação e filtros

> Como percorrer a lista de pré-testes.

`GET /pretests` devolve os pré-testes do workspace, do mais novo para o mais antigo. Ela inclui os criados pela API e os criados na tela.

## Parâmetros

| Parâmetro | Descrição |
| - | - |
| `limit` | Tamanho da página, de 1 a 100. Padrão: 20. |
| `cursor` | O `nextCursor` da página anterior. |
| `status` | `queued`, `processing`, `completed` ou `failed`. |
| `channel` | `ooh`, `digital` ou `email`. |

Valor inválido responde [`invalid_request`](https://docs.myunite.ai/errors#invalid_request) com o nome do parâmetro em `param`.

## Resposta

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "ID_DO_PRETESTE",
      "object": "pretest",
      "status": "completed",
      "channel": "ooh",
      "title": "Verão · relógio urbano",
      "score": 7.4,
      "recommendation": "optimize",
      "createdAt": "2026-11-16T13:00:00.000Z",
      "updatedAt": "2026-11-16T13:04:00.000Z"
    }
  ],
  "nextCursor": "CURSOR_OPACO"
}
```

Enquanto `nextCursor` não for `null`, há mais páginas. Trate o cursor como texto opaco: não o monte nem o altere. Mantenha os mesmos filtros ao longo de todas as páginas.

A lista traz o resumo de cada pré-teste. Para o resultado completo, consulte `GET /pretests/{id}`.

```bash curl theme={null}
curl "https://myunite.ai/api/v1/pretests?status=completed&channel=ooh&limit=50" \
  -H "Authorization: Bearer $UNITE_API_KEY"
```

```javascript JavaScript theme={null}
async function* allCompleted() {
  let cursor;
  do {
    const url = new URL("https://myunite.ai/api/v1/pretests");
    url.searchParams.set("status", "completed");
    url.searchParams.set("limit", "50");
    if (cursor) url.searchParams.set("cursor", cursor);
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.UNITE_API_KEY}` },
    });
    const page = await res.json();
    yield* page.data;
    cursor = page.nextCursor;
  } while (cursor);
}

for await (const item of allCompleted()) console.log(item.title, item.score);
```

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

def all_completed():
    cursor = None
    while True:
        params = {"status": "completed", "limit": 50}
        if cursor:
            params["cursor"] = cursor
        page = requests.get(
            "https://myunite.ai/api/v1/pretests",
            params=params,
            headers={"Authorization": f"Bearer {os.environ['UNITE_API_KEY']}"},
        ).json()
        yield from page["data"]
        cursor = page["nextCursor"]
        if not cursor:
            break

for item in all_completed():
    print(item["title"], item["score"])
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.