---
title: "GET /v1/gameplays"
method: GET
path: "/v1/gameplays"
tags: ["gameplays"]
---

# GET /v1/gameplays

`GET /v1/gameplays`

## Query parameters

- `state` 'all' | 'active' | 'pending' | 'finished'
- `gameId` string
- `asc` boolean
- `start` string
- `limit` number

## Response `200`

List Game Plays Filtered By Status

- ListGameplays
  - `items` Gameplay[], required
    - `gameType` 'POLL' | 'PREDICTION' | 'INSTANT_POLL' | 'TRIVIA' | 'SURVEY' | 'THIS_THAT', required
    - `state` 'waiting_for_match' | 'matched' | 'declared_winner' | 'declared_loser' | 'won' | 'lost' | 'canceled', required
    - `side` 'A' | 'B', required
    - `ticketType` 'white' | 'black' | 'free', required
    - `rewardType` 'microsoft'
    - `achievements` AchievementEntity[]
      - `id` string, required
      - `userId` string, required
      - `createdAt` string, date-time, required
      - `expireAt` string, date-time, required
      - `achievementId` string, required
    - `game` Game, required
      - `audioUrl` string, required
      - `videoUrls` VideoUrls, required
        - `hls` string, required
        - `mp4360` string, required
        - `mp4540` string, required
        - `mp4720` string, required
        - `poster` string, required
      - `questionVideoUrls` VideoUrls, required
        - `hls` string, required
        - `mp4360` string, required
        - `mp4540` string, required
        - `mp4720` string, required
        - `poster` string, required
      - `landscapeVideoUrls` VideoUrls, required
        - `hls` string, required
        - `mp4360` string, required
        - `mp4540` string, required
        - `mp4720` string, required
        - `poster` string, required
      - `resultUrls` VideoUrls, required
        - `hls` string, required
        - `mp4360` string, required
        - `mp4540` string, required
        - `mp4720` string, required
        - `poster` string, required
      - `state` 'new' | 'active' | 'waiting_for_declaration' | 'declaring_winner' | 'winner_declared' | 'changing_game_result' | 'processing_payouts' | 'ended' | 'canceled' | 'refunded' | 'quarantined', required
      - `language` 'en-us' | 'es-mx', required
      - `gameType` 'POLL' | 'PREDICTION' | 'INSTANT_POLL' | 'TRIVIA' | 'SURVEY' | 'THIS_THAT', required
      - `orientation` 'landscape' | 'portrait'
      - `correctAnswer` 'A' | 'B'
      - `id` string, required
      - `creatorId` string, required
      - `creator` Creator, required
        - `avatar` string, required
        - `id` string, required
        - `partnerName` string, required
        - `avatarAssetId` string, required
        - `profileColor` string, required
        - `userName` string, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
      - `startTime` string, date-time, required
      - `endTime` string, date-time, required
      - `lastJoinTime` string, date-time, required
      - `gameTitle` string, required
      - `sourceUrl` string, required
      - `sideA` string, required
      - `sideB` string, required
      - `videoAssetId` string
      - `questionVideoAssetId` string
      - `landscapeVideoAssetId` string
      - `audioAssetId` string
      - `resultAssetId` string
      - `text` string, required
      - `categoryId` string, required
      - `category` Category, required
        - `language` 'en-us' | 'es-mx', required
        - `id` string, required
        - `categoryName` string, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `deletedAt` string, required
        - `sticker` string
        - `icon` string
      - `isAd` boolean, required
      - `isPrivate` boolean
      - `bingSearch` string
      - `bingSearchClaim` string
      - `metadata` object
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `version` number, required
      - `urls` string[]
    - `id` string, required
    - `userId` string, required
    - `gameId` string, required
    - `quantity` number, required
    - `matched` number, required
    - `rewardClaimed` boolean
    - `createdAt` string, date-time, required
    - `opponents` object, required
    - `returnUrl` string, required
    - `sideAPercent` number
    - `majorityBonusWon` boolean
    - `newLeague` 'level1' | 'level2' | 'level3' | 'level4'
  - `next` string, required

---

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