# /api/playerauctions/getPlayerAuctionByID/{id}

* **Parameters:**
  * `id`: The ID of the auction to retrieve.
* **Response:**

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

  ```json
  {
    "id" : 1,
    "auctionCategories" : [ {
      "name" : "blocks",
      "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}"
        }
      },
      "displayName" : "Blocks"
    } ],
    "price" : 1000.0,
    "originalPrice" : 1000.0,
    "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" : [ ]
    },
    "internalCurrency" : null,
    "expireTime" : 172799000,
    "bidding" : false,
    "randomSort" : 0,
    "world" : "world",
    "auctionPlayer" : {
      "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0",
      "messages" : [ ],
      "madeOffline" : [ ],
      "staticAuctions" : 0,
      "logs" : [ ],
      "backpack" : [ ],
      "blacklistedPlayers" : [ ],
      "maximumAuctions" : 9223372036854775807,
      "prettyMaximumAuctions" : "Unlimited",
      "sellPrice" : 500.0,
      "name" : "ForgotUrPassword",
      "language" : null
    },
    "bidder" : null,
    "auctionDate" : 1736121811679,
    "auctionServer" : "PA_SERVER",
    "itemAmount" : 64,
    "unlimited" : false,
    "item" : {
      "type" : "DIRT",
      "amount" : 64
    }
  }
  ```

**Fields:**

* **id** (Number): The unique identifier for this auction entry.
* **auctionCategories** (Array): A list of auction categories.
  * **name** (String): The name of the category.
  * **minPrice** (Number): The minimum price for the category.
  * **maxPrice** (Number): The maximum price for the category.
  * **all** (Boolean): Whether all auctions are included.
  * **icon** (Object): The icon associated with the category.
    * **type** (String): The type of icon.
    * **meta** (Object): Metadata for the icon.
      * **display-name** (String): A formatted string for the display name.
      * **lore** (Array of Strings): A list of lore strings for the item.
      * **PublicBukkitValues** (String): A string containing public Bukkit values.
  * **displayName** (String): The display name for the category.
* **price** (Number): The price of the auction item.
* **originalPrice** (Number): The original price before any adjustments.
* **currency** (Object): Information about the auction currency.
  * **integrated** (Boolean): Whether the currency is integrated.
  * **version** (String): The version of the currency system.
  * **minPricePurchaseAmount** (Number): The minimum price for purchasing.
  * **minPriceSellAmount** (Number): The minimum price for selling.
  * **maxPriceSellAmount** (Number): The maximum price for selling.
  * **minPriceBidAmount** (Number): The minimum bid amount.
  * **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.
* **internalCurrency** (Null or Object): The internal currency used for the auction, if applicable.
* **expireTime** (Number): The expiration time of the auction in milliseconds.
* **bidding** (Boolean): Whether bidding is enabled for the auction.
* **randomSort** (Number): A random sorting value for the auction.
* **world** (String): The world associated with the auction.
* **auctionPlayer** (Object): Information about the player who created the auction.
  * **uuid** (String): The unique identifier for the player.
  * **messages** (Array): A list of messages for the player.
  * **madeOffline** (Array): A list of times the player was made offline.
  * **staticAuctions** (Number): The number of static auctions for the player.
  * **logs** (Array): A list of logs for the player.
  * **backpack** (Array): A list of items in the player's backpack.
  * **blacklistedPlayers** (Array): A list of blacklisted players.
  * **maximumAuctions** (Number): The maximum number of auctions the player can create.
  * **prettyMaximumAuctions** (String): The human-readable version of the maximum auctions.
  * **sellPrice** (Number): The price at which the player sells items.
  * **name** (String): The name of the player.
  * **language** (Null or String): The language setting for the player.
* **bidder** (Null or Object): Information about the bidder, if any.
* **auctionDate** (Number): The auction creation date in milliseconds.
* **auctionServer** (String): The server where the auction is hosted.
* **itemAmount** (Number): The amount of items in the auction.
* **unlimited** (Boolean): Whether the auction has unlimited items.
* **item** (Object): The item being auctioned.
  * **type** (String): The type of the item.
  * **amount** (Number): The amount of the item being auctioned.

**Note:**

* [**Authentication**](https://docs.olziedev.com/projects/playerauctions/restapi/..#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.