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

# Listar Cards

> Lista os cards de um pipeline com filtros e paginação.

Retorna os cards de um pipeline específico. Suporta filtros por estágio, busca textual, data de criação e tags.

<ParamField header="X-Api-Key" type="string" required>
  Sua chave de API (prefixada com `wh_`).
</ParamField>

<ParamField path="pipelineId" type="string" required>
  UUID do pipeline.
</ParamField>

### Query Parameters

<ParamField query="stageId" type="string">
  Filtrar por UUID do estágio.
</ParamField>

<ParamField query="q" type="string">
  Busca textual nos valores do card.
</ParamField>

<ParamField query="createdAfter" type="string">
  Filtrar cards criados após esta data (formato ISO 8601).
</ParamField>

<ParamField query="tags" type="string">
  Tags separadas por vírgula (ex: `hot,enterprise`).
</ParamField>

<ParamField query="page" type="integer" default="0">
  Número da página (base 0).
</ParamField>

<ParamField query="size" type="integer" default="100">
  Quantidade de itens por página (máximo 500).
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://api.whatabot.app/api/v1/kanban/pipelines/pipeline-uuid/cards?stageId=stage-uuid&page=0&size=50" \
    -H "X-Api-Key: wh_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "content": [
      {
        "id": "card-uuid",
        "pipelineId": "pipeline-uuid",
        "stageId": "stage-uuid",
        "sessionId": "session-uuid",
        "tags": ["hot"],
        "values": {
          "name": "João Silva",
          "amount": 1500.00
        },
        "createdAt": "2026-04-20T10:00:00.000Z",
        "movedAt": "2026-04-20T12:30:00.000Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "number": 0,
    "size": 100,
    "first": true,
    "last": true,
    "aggregations": {
      "amount": 1500.00
    }
  }
  ```
</ResponseExample>