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

# List Cards

> List cards from a pipeline with filters and pagination.

Returns the cards of a specific pipeline. Supports filtering by stage, text search, creation date, and tags.

<ParamField header="X-Api-Key" type="string" required>
  Your API key (prefixed with `wh_`).
</ParamField>

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

### Query Parameters

<ParamField query="stageId" type="string">
  Filter by stage UUID.
</ParamField>

<ParamField query="q" type="string">
  Text search across card values.
</ParamField>

<ParamField query="createdAfter" type="string">
  Filter cards created after this date (ISO 8601 format).
</ParamField>

<ParamField query="tags" type="string">
  Comma-separated tags (e.g., `hot,enterprise`).
</ParamField>

<ParamField query="page" type="integer" default="0">
  Page number (zero-based).
</ParamField>

<ParamField query="size" type="integer" default="100">
  Items per page (max 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": "John Doe",
          "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>