/api/playerauctions/getPlayerAuctions/{page}

Retrieve a paginated list of player auctions.

  • Parameters:

    • page: The page number to retrieve (for pagination).

  • Response:

    The response will return a JSON object with the following structure:

    {
      "totalAuctions" : 3,
      "totalPages" : 1,
      "currentPage" : 1,
      "auctions" : [ {
        "randomSort" : 0,
        "originalPrice" : 1000.0,
        "internalCurrency" : null,
        "auctionPlayer" : {
          "logs" : [ ],
          "backpack" : [ ],
          "staticAuctions" : 0,
          "blacklistedPlayers" : [ ],
          "madeOffline" : [ ],
          "maximumAuctions" : 9223372036854775807,
          "prettyMaximumAuctions" : "Unlimited",
          "sellPrice" : 500.0,
          "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
          "messages" : [ ],
          "name" : "ForgotUrPassword",
          "language" : null
        },
        "auctionCategories" : [ {
          "minPrice" : -1.0,
          "maxPrice" : -1.0,
          "all" : false,
          "icon" : {
            "type" : "DIRT",
            "meta" : {
              "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Blocks\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}",
              "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"yellow\"},{\"text\":\" to view all the blocks.\",\"color\":\"aqua\"}],\"italic\":false}" ],
              "PublicBukkitValues" : "{\n    \"playerauctions:itemtag_item\": \"1\"\n}"
            }
          },
          "name" : "blocks",
          "displayName" : "Blocks"
        } ],
        "bidder" : null,
        "price" : 1000.0,
        "bidding" : false,
        "auctionDate" : 1736121811679,
        "expireTime" : 172799000,
        "auctionServer" : "PA_SERVER",
        "itemAmount" : 64,
        "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
        "world" : "world",
        "unlimited" : false,
        "currency" : {
          "integrated" : false,
          "version" : "1.1.0-pre2",
          "minPricePurchaseAmount" : -1.0,
          "minPriceSellAmount" : 1000.0,
          "maxPriceSellAmount" : 9999999.0,
          "minPriceBidAmount" : 1000.0,
          "name" : "Vault Currency",
          "enabled" : true,
          "currencyName" : "money",
          "internalCurrencies" : [ ]
        },
        "id" : 1,
        "item" : {
          "type" : "DIRT",
          "amount" : 64
        }
      }, {
        "randomSort" : 0,
        "originalPrice" : 5000.0,
        "internalCurrency" : null,
        "auctionPlayer" : {
          "logs" : [ ],
          "backpack" : [ ],
          "staticAuctions" : 0,
          "blacklistedPlayers" : [ ],
          "madeOffline" : [ ],
          "maximumAuctions" : 9223372036854775807,
          "prettyMaximumAuctions" : "Unlimited",
          "sellPrice" : 500.0,
          "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
          "messages" : [ ],
          "name" : "ForgotUrPassword",
          "language" : null
        },
        "auctionCategories" : [ {
          "minPrice" : -1.0,
          "maxPrice" : -1.0,
          "all" : false,
          "icon" : {
            "type" : "DIAMOND_PICKAXE",
            "meta" : {
              "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Tools\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}",
              "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"yellow\"},{\"text\":\" to view all the tools.\",\"color\":\"aqua\"}],\"italic\":false}" ],
              "attribute-modifiers" : { },
              "ItemFlags" : [ "HIDE_ATTRIBUTES" ],
              "PublicBukkitValues" : "{\n    \"playerauctions:itemtag_item\": \"1\"\n}"
            }
          },
          "name" : "tools",
          "displayName" : "Tools"
        } ],
        "bidder" : null,
        "price" : 5000.0,
        "bidding" : false,
        "auctionDate" : 1736121853583,
        "expireTime" : 172799000,
        "auctionServer" : "PA_SERVER",
        "itemAmount" : 1,
        "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
        "world" : "world",
        "unlimited" : false,
        "currency" : {
          "integrated" : false,
          "version" : "1.1.0-pre2",
          "minPricePurchaseAmount" : -1.0,
          "minPriceSellAmount" : 1000.0,
          "maxPriceSellAmount" : 9999999.0,
          "minPriceBidAmount" : 1000.0,
          "name" : "Vault Currency",
          "enabled" : true,
          "currencyName" : "money",
          "internalCurrencies" : [ ]
        },
        "id" : 2,
        "item" : {
          "type" : "DIAMOND_SWORD"
        }
      }, {
        "randomSort" : 0,
        "originalPrice" : 50000.0,
        "internalCurrency" : null,
        "auctionPlayer" : {
          "logs" : [ ],
          "backpack" : [ ],
          "staticAuctions" : 0,
          "blacklistedPlayers" : [ ],
          "madeOffline" : [ ],
          "maximumAuctions" : 9223372036854775807,
          "prettyMaximumAuctions" : "Unlimited",
          "sellPrice" : 500.0,
          "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
          "messages" : [ ],
          "name" : "ForgotUrPassword",
          "language" : null
        },
        "auctionCategories" : [ {
          "minPrice" : -1.0,
          "maxPrice" : -1.0,
          "all" : false,
          "icon" : {
            "type" : "DIAMOND_HELMET",
            "meta" : {
              "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Armor\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}",
              "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"yellow\"},{\"text\":\" to view all the armor.\",\"color\":\"aqua\"}],\"italic\":false}" ],
              "attribute-modifiers" : { },
              "ItemFlags" : [ "HIDE_ATTRIBUTES" ],
              "PublicBukkitValues" : "{\n    \"playerauctions:itemtag_item\": \"1\"\n}"
            }
          },
          "name" : "armor",
          "displayName" : "Armor"
        } ],
        "bidder" : null,
        "price" : 50000.0,
        "bidding" : false,
        "auctionDate" : 1736121916482,
        "expireTime" : 172799000,
        "auctionServer" : "PA_SERVER",
        "itemAmount" : 1,
        "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
        "world" : "world",
        "unlimited" : false,
        "currency" : {
          "integrated" : false,
          "version" : "1.1.0-pre2",
          "minPricePurchaseAmount" : -1.0,
          "minPriceSellAmount" : 1000.0,
          "maxPriceSellAmount" : 9999999.0,
          "minPriceBidAmount" : 1000.0,
          "name" : "Vault Currency",
          "enabled" : true,
          "currencyName" : "money",
          "internalCurrencies" : [ ]
        },
        "id" : 3,
        "item" : {
          "type" : "DIAMOND_CHESTPLATE",
          "meta" : {
            "enchants" : {
              "minecraft:mending" : 1,
              "minecraft:protection" : 5,
              "minecraft:unbreaking" : 3
            }
          }
        }
      } ]
    }

Fields:

  • totalAuctions (Number): The total number of auctions available.

  • totalPages (Number): The total number of pages for the auctions.

  • currentPage (Number): The current page number being viewed.

  • auctions (Array): A list of auction items.

    • randomSort (Number): A random sort value for the auction.

    • originalPrice (Number): The original price of the auction item.

    • internalCurrency (Null): The internal currency value (null).

    • auctionPlayer (Object): Information about the player who created the auction.

      • logs (Array): A list of logs related to the player (empty array).

      • backpack (Array): A list of items in the player's backpack (empty array).

      • staticAuctions (Number): Number of static auctions allowed for the player.

      • blacklistedPlayers (Array): List of blacklisted players (empty array).

      • madeOffline (Array): A list of times the player was made offline (empty array).

      • maximumAuctions (Number): The maximum number of auctions the player can create.

      • prettyMaximumAuctions (String): Human-readable format of maximum auctions.

      • sellPrice (Number): The price at which the player can sell items.

      • uuid (String): The unique identifier for the player.

      • messages (Array): A list of messages related to the player (empty array).

      • name (String): The name of the player.

      • language (Null): The language of the player (null).

    • auctionCategories (Array): A list of auction categories.

      • minPrice (Number): The minimum price for the auction category.

      • maxPrice (Number): The maximum price for the auction category.

      • all (Boolean): Whether the category applies to all auctions.

      • icon (Object): The icon for the category.

        • type (String): The type of icon.

        • meta (Object): Metadata for the icon.

          • display-name (String): Display name for the category.

          • lore (Array of Strings): A list of lore descriptions.

          • PublicBukkitValues (String): A string representing public Bukkit values.

      • displayName (String): The name displayed for the auction category.

    • price (Number): The price of the auction item.

    • originalPrice (Number): The original price of the auction item.

    • currency (Object): Information about the currency used in the auction.

      • integrated (Boolean): Whether the currency is integrated into the auction.

      • version (String): The version of the currency system.

      • minPricePurchaseAmount (Number): The minimum purchase amount for the auction item.

      • minPriceSellAmount (Number): The minimum sell amount for the auction item.

      • maxPriceSellAmount (Number): The maximum sell amount for the auction item.

      • minPriceBidAmount (Number): The minimum bid amount for the auction item.

      • name (String): The name of the currency.

      • enabled (Boolean): Whether the currency is enabled.

      • currencyName (String): The name of the currency.

      • internalCurrencies (Array): A list of internal currencies associated with the auction.

    • internalCurrency (Null or Object): The internal currency used, if applicable (null or object).

    • expireTime (Number): The expiration time of the auction item in milliseconds.

    • bidding (Boolean): Whether bidding is allowed for the auction.

    • randomSort (Number): A random value used to sort auctions.

    • world (String): The world associated with the auction.

    • auctionPlayer (Object): Details of the auction player (see above).

    • bidder (Null or Object): Information about the bidder, if applicable (null or object).

    • auctionDate (Number): The date when the auction was created, in milliseconds.

    • auctionServer (String): The server where the auction is hosted.

    • itemAmount (Number): The number of items listed in the auction.

    • unlimited (Boolean): Whether the auction has unlimited items.

    • item (Object): Details of the item being auctioned.

      • type (String): The type of the item.

      • amount (Number): The amount of the item being auctioned.

Note:

  • Authentication is required to access this endpoint.

  • Based on server settings, you may not be able to access auction information if you do not own the auction.

Last updated

Was this helpful?