---
title: "Listar"
method: GET
path: "/v2/panel/card"
tags: ["Cards"]
---

# Listar

`GET /v2/panel/card`

Listagem paginada de cards.

## Query parameters

- `PanelId` string, uuid, required
- `StepId` string, uuid
- `ContactId` string, uuid
- `ResponsibleUserId` string, uuid
- `TextFilter` string
- `IncludeDetails` string[]
- `Statuses` string[]
- `CreatedAt.Before` string, date-time
- `CreatedAt.After` string, date-time
- `UpdatedAt.Before` string, date-time
- `UpdatedAt.After` string, date-time
- `PageNumber` integer
- `PageSize` integer
- `OrderBy` string
- `OrderDirection` 'ASCENDING' | 'DESCENDING'

## Response `200`

Success

- PublicPanelCardDTOV2PublicPageListDTO
  - `pageNumber` integer — Número da página a ser obtida.
  - `pageSize` integer — Tamanho da página a ser obtida.
  - `orderBy` string, nullable — Nome do campo para ser utilizado como pivô da ordenação.
  - `orderDirection` 'ASCENDING' | 'DESCENDING', nullable — Determina se a ordenação deve ser crescente ou decrescente.
  - `items` PublicPanelCardDTOV2[], nullable
    - `id` string, uuid
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `companyId` string, uuid
    - `panelId` string, uuid
    - `panelTitle` string, nullable
    - `stepId` string, uuid
    - `stepTitle` string, nullable
    - `stepPhase` 'NONE' | 'INITIAL' | 'FINAL', nullable
    - `position` number, double
    - `title` string, nullable
    - `description` string, nullable
    - `key` string, nullable
    - `number` integer
    - `dueDate` string, date-time, nullable
    - `isOverdue` boolean
    - `tagIds` string[], nullable
    - `sessionId` string, uuid, nullable
    - `monetaryAmount` number, double, nullable
    - `responsibleUserId` string, uuid, nullable
    - `responsibleUser` PublicPanelCardResponsibleUserDTO
      - `id` string, uuid
      - `name` string, nullable
    - `contactIds` string[], nullable
    - `contacts` PublicPanelCardContactDTO[], nullable
      - `id` string, uuid
      - `name` string, nullable
    - `customFields` object, nullable
    - `metadata` object, nullable
    - `status` 'OPEN' | 'WON' | 'LOST' | 'ARCHIVED'
    - `lostReason` LostReasonDTO
      - `id` string, uuid, nullable
      - `name` string, nullable
  - `totalItems` integer
  - `totalPages` integer
  - `hasMorePages` boolean

## Other responses

- `500` — Server Error

---

[API](https://skmtc.net/helena/apis/core.md) · [All operations](https://skmtc.net/helena/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/helena/core/versions/811b2cdd2ec2/schema)