Skip to content

feat: Add GET /api/seasons endpoint method#113

Merged
DocDvorak merged 1 commit into
screepers:masterfrom
DocDvorak:seasons-list
Jun 19, 2026
Merged

feat: Add GET /api/seasons endpoint method#113
DocDvorak merged 1 commit into
screepers:masterfrom
DocDvorak:seasons-list

Conversation

@DocDvorak

Copy link
Copy Markdown
Contributor

ScreepsHttpClient.seasonsList: Fetch a list of all past, current, and upcoming Seasonal World competitions.

Sample output:
yarn run cli call seasonsList / screeps-api call seasonsList:

{
  "ok": 1,
  "list": [
    {
      "_id": "5fa0be4c7e69672e14b58728",
      "index": 1,
      "title": "Season 1",
      "players": 2121,
      "createdAt": "2020-10-01T17:13:07.495Z",
      "updatedAt": "2020-10-01T17:13:07.495Z",
      "startDate": "2020-12-01T00:00:00.000Z",
      "endDate": "2021-02-01T00:00:00.000Z"
    },
    {
      "_id": "6027a69fc48dec25dc7e1f1d",
      "index": 2,
      "title": "Season 2",
      "players": 0,
      "createdAt": "2021-02-15T18:00:00.000Z",
      "updatedAt": "2021-02-15T18:00:00.000Z",
      "startDate": "2021-03-01T18:00:00.000Z",
      "endDate": "2021-05-01T18:00:00.000Z"
    },
    // ... snip ...
    {
      "_id": "699082f4c916952a7e71e9d6",
      "title": "Season 8",
      "createdAt": "2026-02-14T14:00:00.000Z",
      "endDate": "2026-05-01T18:00:00.000Z",
      "index": 8,
      "players": 0,
      "startDate": "2025-03-01T18:00:00.000Z",
      "updatedAt": "2026-02-14T14:00:00.000Z"
    },
    {
      "_id": "6a1dcf58208a4e8e6e090980",
      "title": "Season 10",
      "createdAt": "2026-06-14T14:00:00.000Z",
      "endDate": "2026-08-01T18:00:00.000Z",
      "index": 10,
      "players": 0,
      "startDate": "2025-06-03T18:00:00.000Z",
      "updatedAt": "2026-09-01T14:00:00.000Z"
    }
  ]
}

@DocDvorak DocDvorak merged commit 0f3c7c6 into screepers:master Jun 19, 2026
2 checks passed
@DocDvorak DocDvorak deleted the seasons-list branch June 19, 2026 22:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant