Service provided by Openplanet

- Join Discord

Contribute on Github

Get club activities

GET https://live-services.trackmania.nadeo.live/api/token/club/{clubId}/activity?length={length}&offset={offset}&active={active}

Headers:

Path parameters:

  • {clubId} integer The club's ID *

Query parameters:

  • {length} integer The number of activities to retrieve *
    Maximum: 250
  • {offset} integer The number of activities to skip *
  • {active} Boolean Optional filter for enabled/disabled activities
  • {folderId} string Optional filter for activities in a folder

Gets a list of club activities, including news, rooms, campaigns, and others.

Remarks:

  • Omitting the active parameter implicitly requests both enabled and disabled activities. For clubs you are not an admin of, active needs to be explicitly set to true because only admins are allowed to see disabled activities - otherwise you'll get an error complaining that you're not a member/admin of the club.
  • As of 2024-01-17, this endpoint's response links to .dds media files by default, while several scaled .png versions are available using separate fields (see example below for reference). This only applies for custom media files, and not for preset themes.
  • By default, all activities (including ones nested in folders) are returned. To only retrieve activities in a specific folder, use folderId to filter them. Setting folderId to 0 only returns activities outside of folders.

Example request:

GET https://live-services.trackmania.nadeo.live/api/token/club/4764/activity?length=3&offset=0&active=true

Example response:

{
  "activityList": [
    {
      "id": 35474,
      "name": "$ec0Discord",
      "activityType": "news",
      "activityId": 35474,
      "targetActivityId": 35474,
      "campaignId": 0,
      "position": 0,
      "public": true,
      "active": true,
      "externalId": 0,
      "featured": false,
      "password": false,
      "itemsCount": 0,
      "clubId": 4764,
      "editionTimestamp": 1594152754,
      "creatorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "latestEditorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "mediaUrl": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/86ada7a9-f401-4832-be60-631bb63f01a4/dds/game.dds?timestamp=1705418454.dds",
      "mediaUrlPngLarge": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/86ada7a9-f401-4832-be60-631bb63f01a4/png/large.png?timestamp=1705418454.png",
      "mediaUrlPngMedium": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/86ada7a9-f401-4832-be60-631bb63f01a4/png/medium.png?timestamp=1705418454.png",
      "mediaUrlPngSmall": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/86ada7a9-f401-4832-be60-631bb63f01a4/png/small.png?timestamp=1705418454.png",
      "mediaUrlDds": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/86ada7a9-f401-4832-be60-631bb63f01a4/dds/game.dds?timestamp=1705418454.dds",
      "mediaTheme": ""
    },
    {
      "id": 68012,
      "name": "$ec0TMS $fffRoad",
      "activityType": "campaign",
      "activityId": 68012,
      "targetActivityId": 68012,
      "campaignId": 2649,
      "position": 1,
      "public": true,
      "active": true,
      "externalId": 2649,
      "featured": false,
      "password": false,
      "itemsCount": 15,
      "clubId": 4764,
      "editionTimestamp": 1595625959,
      "creatorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "latestEditorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "mediaUrl": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/1636a29e-bbe2-4321-acc3-a523dd2c94ef/dds/game.dds?timestamp=1705418451.dds",
      "mediaUrlPngLarge": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/1636a29e-bbe2-4321-acc3-a523dd2c94ef/png/large.png?timestamp=1705418451.png",
      "mediaUrlPngMedium": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/1636a29e-bbe2-4321-acc3-a523dd2c94ef/png/medium.png?timestamp=1705418451.png",
      "mediaUrlPngSmall": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/1636a29e-bbe2-4321-acc3-a523dd2c94ef/png/small.png?timestamp=1705418451.png",
      "mediaUrlDds": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/1636a29e-bbe2-4321-acc3-a523dd2c94ef/dds/game.dds?timestamp=1705418451.dds",
      "mediaTheme": ""
    },
    {
      "id": 35159,
      "name": "TM$ec0S $fffDirt",
      "activityType": "campaign",
      "activityId": 35159,
      "targetActivityId": 35159,
      "campaignId": 1094,
      "position": 3,
      "public": true,
      "active": true,
      "externalId": 1094,
      "featured": false,
      "password": false,
      "itemsCount": 11,
      "clubId": 4764,
      "editionTimestamp": 1594148450,
      "creatorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "latestEditorAccountId": "a26bcfd0-cd7f-4477-b514-eab711dfaf61",
      "mediaUrl": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/75ff0c45-3c4b-47c9-a99c-208f8fc017d9/dds/game.dds?timestamp=1705402100.dds",
      "mediaUrlPngLarge": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/75ff0c45-3c4b-47c9-a99c-208f8fc017d9/png/large.png?timestamp=1705402100.png",
      "mediaUrlPngMedium": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/75ff0c45-3c4b-47c9-a99c-208f8fc017d9/png/medium.png?timestamp=1705402100.png",
      "mediaUrlPngSmall": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/75ff0c45-3c4b-47c9-a99c-208f8fc017d9/png/small.png?timestamp=1705402100.png",
      "mediaUrlDds": "https://trackmania-prod-media-s3.cdn.ubi.com/media/image/live-api/75ff0c45-3c4b-47c9-a99c-208f8fc017d9/dds/game.dds?timestamp=1705402100.dds",
      "mediaTheme": ""
    }
  ],
  "maxPage": 7,
  "itemCount": 20
}

If the clubId is invalid, the response will contain an empty list of activities.