Get club upload activity by ID

Gets the maps, items, or skins in a specific upload activity.

GET https://live-services.trackmania.nadeo.live/api/token/club/{clubID}/bucket/{activityId}?length={length}&offset={offset}

Headers:


Path parameters:

  • {clubID} integer The ID of the club the upload activity belongs to *
  • {activityId} integer The activity ID of the upload activity to be requested *

Query parameters:

  • {length} integer The number of items to retrieve
    Default: 10
  • {offset} integer The number of items to skip
    Default: 0

Remarks:

  • See the glossary for a list of upload types that can be returned by this endpoint.
  • The primary identifier for items in the returned bucket is their itemId. For maps this will be a mapUid and for skins this is a skinID.
  • As of 2024-01-17, this endpoint’s response links to .dds media files by default, while several scaled .png/.jpg versions are available using separate fields (see example below for reference). This only applies for custom media files, and not for preset themes.

Example request:

GET https://live-services.trackmania.nadeo.live/api/token/club/42175/bucket/344426

Example response:

{
  "type": "map-upload",
  "bucketItemList": [
    {
      "itemId": "zOAI0h0WgikjTVv2RHcPShABLq0",
      "position": 0,
      "description": "",
      "mediaUrls": [],
      "mediaUrlsJpgLarge": [],
      "mediaUrlsJpgMedium": [],
      "mediaUrlsJpgSmall": [],
      "mediaUrlsDds": []
    },
    ...
    {
      "itemId": "wQS2NQxwV_PVweJb1MoBwft2bs6",
      "position": 9,
      "description": "",
      "mediaUrls": [],
      "mediaUrlsJpgLarge": [],
      "mediaUrlsJpgMedium": [],
      "mediaUrlsJpgSmall": [],
      "mediaUrlsDds": []
    }
  ],
  "bucketItemCount": 63,
  "popularityLevel": 0,
  "popularityValue": 0,
  "creationTimestamp": 1673276709,
  "creatorAccountId": "fc8467b8-b253-457f-b8bb-3bbd2bb5bfdd",
  "latestEditorAccountId": "fc8467b8-b253-457f-b8bb-3bbd2bb5bfdd",
  "id": 344426,
  "clubId": 42175,
  "clubName": "$Z$f72ArEyeses$fff' $888Club",
  "name": "Randomly Generated G",
  "mediaUrl": "",
  "mediaUrlPngLarge": "",
  "mediaUrlPngMedium": "",
  "mediaUrlPngSmall": "",
  "mediaUrlDds": "",
  "mediaTheme": ""
}

If the club or upload activity does not exist, the response will contain an error (status 404):

["activity:error-notFound"]

If the upload activity is private and the player is not a member of the club, the response will contain an error (status 403):

["clubMemberRole:error-notMember"]