Skip to content
DonutStatsAPI
Sign up
Object

Player

Everything we know about one player.

Returned by GET /v1/players/{username}.

Returned by

Fields

  • usernamestring

    Username with its current capitalization.

  • uuidstring | null

    Minecraft UUID, once known.

  • firstSeenAttimestamp

    When the player first appeared in DonutStats.

  • lastSeenAttimestamp

    When the player last showed up anywhere: chat, a leaderboard, a listing or a lookup.

  • lastChatAttimestamp | null

    When the player last chatted in public chat.

  • statsobject

    Every stat we know. A stat is left out until we have it.

    Show8 child fields
    • moneynumber

      Balance in DonutSMP dollars.

    • shardsinteger

      Shards held.

    • killsinteger

      Player kills.

    • deathsinteger

      Deaths.

    • playtimeinteger

      Playtime in seconds.

    • placedBlocksinteger

      Blocks placed.

    • brokenBlocksinteger

      Blocks broken.

    • mobsKilledinteger

      Mobs killed.

  • statsUpdatedAttimestamp | null

    When the player's full stats were last refreshed.

  • valuesUpdatedAttimestamp | null

    When any single stat last changed, including from a leaderboard.

  • ranksobject

    The player's place on each leaderboard they appear on, keyed by board id (money, deaths, playtime, placedBlocks, brokenBlocks, mobsKilled).

    Show3 child fields
    • rankinteger

      Position on the leaderboard, starting at 1.

    • valuenumber

      The ranked value.

    • updatedAttimestamp

      When that leaderboard snapshot was complete.

  • views30dinteger

    Profile views on DonutStats in the last 30 days.

  • viewsTotalinteger

    Profile views on DonutStats, all time.

  • listingsobject

    What the player is selling on the auction house.

    Show3 child fields
    • openinteger

      Open listings by this player.

    • valuenumber

      Total asking price of those listings.

    • checkedAttimestamp | null

      When the player's listings were last refreshed. null if never.

  • presenceobject

    Whether the player is online, as of the last refresh.

    Show4 child fields
    • onlineboolean | null

      true when they were online at checkedAt.

    • pingMsinteger | null

      Their ping in milliseconds, when online.

    • checkedAttimestamp | null

      When presence was checked.

    • lastOnlineAttimestamp | null

      The last time they were seen online.

  • bountyobject | null

    The open bounty on this player, or null.

    Show2 child fields
    • amountnumber

      Bounty in DonutSMP dollars.

    • sincetimestamp

      When the bounty first appeared.