> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seesaw.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# get_contest

> World Cup pick'em contests: schedule, options, and results

SeeSaw's pick'em contests (currently: FIFA World Cup 2026 matches). One tool,
two modes: pass `contest_id` for one contest, omit it to **list** contests
with filters.

**REST equivalents**: `GET /open/v1/contests/{id}` and `GET /open/v1/contests`

## Parameters

| Name               | Type                                                              | Required | Notes        |
| ------------------ | ----------------------------------------------------------------- | -------- | ------------ |
| `contest_id`       | string (uuid)                                                     |          | Omit to list |
| `status`           | `upcoming` \| `open` \| `pending_reveal` \| `settled` \| `voided` |          | List mode    |
| `round`            | string                                                            |          | List mode    |
| `cursor` / `limit` |                                                                   |          | List mode    |

## Returns

Single contest, captured live:

```json theme={null}
{
  "id": "69f83c8a-e24e-47ab-ba30-f53fa0f4c2c5",
  "title": "Final · Match 104",
  "description": "FIFA World Cup 2026 · Final · Match 104 · New York/New Jersey Stadium, New Jersey. Predict the champion (extra time and penalties included).",
  "status": "upcoming",
  "start_time": "2026-07-19T18:59:59Z",
  "deadline": "2026-07-19T19:00:00Z",
  "options": [
    { "id": "36ca7dde-337a-44df-92bd-ba73e85fc717", "title": "W101", "entries_count": 0, "is_correct": false },
    { "id": "2996c1dc-2983-41bc-8e17-87e6061f20e7", "title": "W102", "entries_count": 0, "is_correct": false }
  ],
  "entries_count": 0
}
```

Field notes:

* Knockout fixtures not yet determined show placeholder option titles
  (`W101` = "winner of match 101"); they update once the bracket resolves.
* After settlement, the winning option has `is_correct: true`, and the
  contest carries `settled_at` (or `void_reason` if voided).
* List mode returns `{data, next_cursor, has_more}` of the same objects.

## Example prompts

* "What World Cup matches can I pick this week?"
* "Show the final — who's the favorite by entries?"
* "Which settled contests did most people get wrong?"

## Related

[`get_leaderboard`](/mcp/tools/get-leaderboard) (contest scope) ·
[`list_topics`](/mcp/tools/list-topics)