---
title: "List tracks with pagination"
method: GET
path: "/api/v1/tracks"
tags: ["cms"]
---

# List tracks with pagination

`GET /api/v1/tracks`

## Query parameters

- `ids` string[], nullable
- `page` number
- `limit` number
- `missionReferenceIds` string[]
- `searchString` string
- `search` string
- `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans'
- `sagaType` string[]
- `accessLevel` string[]
- `status` string[]
- `conversationTopic` 'prospecting_and_outreach' | 'discovery_and_qualification' | 'pitching_and_presenting' | 'objection_handling' | 'negotiation' | 'customer_retention' | 'expansion' | 'essential_conversational_skills' | 'sales_leadership' | 'customer_support'

## Response `201`

- TrackFindResponseDTO — Paginated response for tracks.
  - `data` object[], required
    - `conversation_topic` string[], required — Topics for conversation in the track.
    - `description` string, required — A description of the track.
    - `id` string, required — The unique identifier for the track.
    - `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans', required
    - `learning_outcome` string, required — The overall learning outcome for the whole track — the concrete behaviors or skills a seller will be able to do after completing it.
    - `missions` object[], required — A list of short missions included in the track.
      - `avatar` object, required — Avatar images for the mission persona
        - `cardUrl` string — Card-sized version of the avatar
        - `thumbnailUrl` string — Thumbnail version of the avatar
        - `url` string, required — Primary avatar image URL
      - `difficulty` string, required — Difficulty level of the mission
      - `duration` number, required — Expected duration of the mission in minutes
      - `id` string, required — Unique identifier for the mission
      - `sagaId` string, required — Identifier of the saga this mission belongs to
      - `scenario_description` string — Situational context for the seller entering this roleplay
      - `taskCount` integer, required — Number of scorecard tasks (items) defined for this mission
      - `title` string, required — Title of the mission
      - `trackId` string — Identifier of the track this mission belongs to (if any)
      - `trackTitle` string — Title of the track this mission belongs to (if any)
    - `sagaId` string, required — The ID of the saga this track belongs to.
    - `sagaType` 'under_construction' | 'generic' | 'client_specific', required — The type of the saga this track belongs to.
    - `status` 'published' | 'draft' | 'processing' | 'processing_error', required — The publication status of the track.
    - `title` string, required — The title of the track.
  - `meta` object, required
    - `hasNext` boolean, required
    - `limit` number, required
    - `page` number, required
    - `total` number, required

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)