Accolades

Accolades are leaderboard entries that track user achievements and statistics in Local Universe. They are backed by user stats and can be filtered by stat type and key.

The accolade model

Properties

  • Name
    stat_value
    Type
    number
    Description

    The stat value for this entry.

  • Name
    key
    Type
    string
    Description

    The stat key (e.g. an item ID for per-species stats).

  • Name
    updated_at
    Type
    string
    Description

    When the stat was last updated.

  • Name
    user
    Type
    object
    Description

    The user who holds this accolade. Contains id, username, display_name, and avatar.

  • Name
    item
    Type
    object?
    Description

    The associated item, if applicable. Contains id, name, icon, and rarity. Null when no item is associated.

User stat types

ValueNameDescription
1FISHING_TOTAL_CAUGHTTotal number of fish caught
2FISHING_TOTAL_WEIGHTTotal weight of all fish caught
3FISHING_SPECIES_CAUGHTNumber of a specific species caught
4FISHING_SPECIES_MAX_WEIGHTHeaviest catch of a specific species
5FISHING_SPECIES_TOTAL_WEIGHTTotal weight caught of a specific species

GET/v1/accolades/:type

List accolades

Returns accolades for a given stat type, sorted by stat value descending.

Query parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of entries to return (1-100). Default: 50.

  • Name
    offset
    Type
    integer
    Description

    Number of entries to skip for pagination. Default: 0.

Request

GET
/v1/accolades/1?limit=10
curl "https://api.localuniverse.io/v1/accolades/1?limit=10" \
  -H "Authorization: Bearer {token}"

Response

[
  {
    "stat_value": 542,
    "key": "",
    "updated_at": "2025-06-15T12:30:00.000Z",
    "user": {
      "id": "1344387816333352652",
      "username": "tino",
      "display_name": "Tino",
      "avatar": "https://cdn.localuniverse.io/avatars/1344387816333352652/avatar.png"
    },
    "item": null
  }
]

GET/v1/accolades/:type/:key

Get accolades by key

Returns accolades for a specific stat type and key. For example, per-species fishing stats where the key is the item ID.

Query parameters

  • Name
    limit
    Type
    integer
    Description

    Maximum number of entries to return (1-100). Default: 50.

  • Name
    offset
    Type
    integer
    Description

    Number of entries to skip for pagination. Default: 0.

Request

GET
/v1/accolades/4/1344387816333355555
curl "https://api.localuniverse.io/v1/accolades/4/1344387816333355555" \
  -H "Authorization: Bearer {token}"

Response

[
  {
    "stat_value": 24.5,
    "key": "1344387816333355555",
    "updated_at": "2025-06-15T12:30:00.000Z",
    "user": {
      "id": "1344387816333352652",
      "username": "tino",
      "display_name": "Tino",
      "avatar": "https://cdn.localuniverse.io/avatars/1344387816333352652/avatar.png"
    },
    "item": {
      "id": "1344387816333355555",
      "name": "Cosmic Trout",
      "icon": "https://cdn.localuniverse.io/items/cosmic-trout.png",
      "rarity": 4
    }
  }
]

Was this page helpful?