---
title: "Get List"
method: POST
path: "/list"
---

# Get List

`POST /list`

## Request

- Base URL: `https://backend.praktiki.io` (the document declares no server; this is the origin it was published from)
- URL: `https://backend.praktiki.io/list`
- Auth: HTTP bearer

List entities with pagination, permission checks, and metadata.

Supports all entity types from both the Flask backend and the FastAPI backend:
- Content types (Scenario, Collection, Chat, ScenarioSession): rich path with
  pagination, filters, sort, access-level enrichment, and default bookmark creation.
- Legacy types (User, UserActivity, TeamMember, Team, Notification, Task,
  Character, and others): simple fetch path mirroring Flask backend behaviour.

Args:
    request: FastAPI request object (for compatibility with decorators).
    payload: Request body.
    user: Authenticated user data.

Returns:
    Dictionary with 'data' (list of entities), 'total_count', and optional 'next_page_token'.

Raises:
    HTTPException: For invalid requests (400) or access denied (403).

## Request body

- ListRequest: Request payload for listing entities with optional pagination and filtering.
  - `entity_type` string, nullable
  - `id` union
    - string
    - string[]
  - `keys` union
    - string
    - string[]
  - `field_paths` string[], nullable
  - `access_mode` string, nullable
  - `limit` integer, nullable
  - `page_token` string, nullable
  - `filters` ApisEndpointsListApisFilterOption[], nullable
    - `key` string, required
    - `value` unknown, required
    - `op_string` string
  - `sort` ApisEndpointsListApisSortOption: Sort option for content sorting.
    - `field_path` string, required
    - `direction` string
  - `type` union
    - string
    - string[]
  - `date_range` object, nullable
  - `topic_ids` string[], nullable
  - `team_id` string, nullable
  - `assignee_id` string, nullable
  - `scenario_id` string, nullable
  - `is_session_completed` boolean, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/praktiki/apis/praktiki-api.md) - [All operations](https://skmtc.dev/praktiki/apis/praktiki-api/llms.txt) - [OpenAPI document](https://skmtc.dev/praktiki/apis/praktiki-api/revisions/3428f9e0a922?raw)