---
title: "Get upcoming competitions"
method: GET
path: "/api/competitions/upcoming"
tags: ["Competition"]
---

# Get upcoming competitions

`GET /api/competitions/upcoming`

Get all competitions that have not started yet (status=PENDING)

## Response `200`

Upcoming competitions retrieved successfully

- object
  - `success` boolean — Operation success status
  - `competitions` object[]
    - `id` string — Competition ID
    - `name` string — Competition name
    - `description` string, nullable — Competition description
    - `externalUrl` string, nullable — External URL for competition details
    - `imageUrl` string, nullable — URL to competition image
    - `status` 'pending' — Competition status (always pending)
    - `type` 'trading' — Competition type
    - `crossChainTradingType` 'disallowAll' | 'disallowXParent' | 'allow' — The type of cross-chain trading allowed in this competition
    - `createdAt` string, date-time — When the competition was created
    - `updatedAt` string, date-time — When the competition was last updated

## Other responses

- `401` — Unauthorized - Missing or invalid authentication
- `500` — Server error

## Changes

- **2025-06-30** `e0d0a475d4b6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/recallnet/apis/trading-simulator-api/changes/api/competitions/upcoming/get.md)

---

[API](https://skmtc.dev/recallnet/apis/trading-simulator-api.md) · [All operations](https://skmtc.dev/recallnet/apis/trading-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recallnet/trading-simulator-api/revisions/c4fff489ea72/schema)