# /api/playerwarps/getPlayerWarps/{page} * **Parameters:** * `page`: The page number to retrieve (for pagination). * `locked`: Optional query parameter (`true/false`) to filter by locked warps. (Default false) * **Response:** The response will return a JSON object with the following structure: ```json { "warps" : [ { "id" : 50, "warpName" : "testing", "warpLocation" : { "world" : "world", "x" : -1704.254518797315, "y" : 81.79549733866219, "z" : -90.22482751188485, "yaw" : -22.475004, "pitch" : 43.49976, "locationSafe" : false, "warpServer" : "N/A", "properLocation" : { "world" : "world", "x" : -1704.254518797315, "y" : 81.79549733866219, "z" : -90.22482751188485, "yaw" : -22.475004, "pitch" : 43.49976 }, "worldType" : "world" }, "warpRate" : { "earnedRateRewards" : [ ], "rates" : { }, "rateAverage" : 0.0, "totalRates" : 0, "playersRatedAmount" : 0 }, "warpCategory" : [ { "name" : "other", "teleportPrice" : -1.0, "purgeTime" : -1, "permission" : "", "removeDaysTime" : -1, "all" : false, "icon" : { "type" : "PAPER", "meta" : { "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Other Warps\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}", "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"light_purple\"},{\"text\":\" to view all the other warps.\",\"color\":\"aqua\"}],\"italic\":false}" ], "PublicBukkitValues" : "{\n \"playerwarps:itemtag_item\": \"1\"\n}" } }, "displayName" : "Other" } ], "warpIcon" : { "warpIcon" : null }, "warpRent" : { "warpLastRent" : 1735593109313, "warpNewRent" : 1735679509313 }, "warpVisit" : { "warpVisits" : 0, "purgedWarpVisits" : 0, "warpVisitedBoosted" : [ ], "warpVisited" : [ ] }, "warpDate" : 1735593109313, "warpType" : "NORMAL", "warpCost" : null, "paid" : [ ], "banned" : [ ], "whitelisted" : [ ], "managers" : [ ], "whitelistEnabled" : false, "warpLocked" : false, "warpPassword" : null, "sponsorWarp" : null, "sponsorCooldown" : null, "randomSort" : 0, "warpPlayer" : { "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0", "messages" : [ ], "sponsorCooldown" : null, "staticWarps" : 0, "logs" : [ ], "earnedRateRewards" : [ ], "lastPlayed" : 1735593166487, "pendingWarp" : null, "maxWarpCostPrice" : 500.0, "minWarpCostPrice" : -1.0, "priceFreeLimit" : -1, "waitTeleportTime" : 3, "maximumWarps" : 9223372036854775807, "prettyMaximumWarps" : "Unlimited", "name" : "ForgotUrPassword", "language" : "en_gb" }, "favoriteCount" : 0, "warpDisplayName" : "testing" }, { "id" : 51, "warpName" : "testing2", "warpLocation" : { "world" : "world", "x" : -1696.604230492617, "y" : 85.53986305993527, "z" : -71.72780318647382, "yaw" : -22.475004, "pitch" : 43.49976, "locationSafe" : false, "warpServer" : "N/A", "properLocation" : { "world" : "world", "x" : -1696.604230492617, "y" : 85.53986305993527, "z" : -71.72780318647382, "yaw" : -22.475004, "pitch" : 43.49976 }, "worldType" : "world" }, "warpRate" : { "earnedRateRewards" : [ ], "rates" : { }, "rateAverage" : 0.0, "totalRates" : 0, "playersRatedAmount" : 0 }, "warpCategory" : [ { "name" : "other", "teleportPrice" : -1.0, "purgeTime" : -1, "permission" : "", "removeDaysTime" : -1, "all" : false, "icon" : { "type" : "PAPER", "meta" : { "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Other Warps\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}", "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"light_purple\"},{\"text\":\" to view all the other warps.\",\"color\":\"aqua\"}],\"italic\":false}" ], "PublicBukkitValues" : "{\n \"playerwarps:itemtag_item\": \"1\"\n}" } }, "displayName" : "Other" } ], "warpIcon" : { "warpIcon" : null }, "warpRent" : { "warpLastRent" : 1735593112612, "warpNewRent" : 1735679512612 }, "warpVisit" : { "warpVisits" : 0, "purgedWarpVisits" : 0, "warpVisitedBoosted" : [ ], "warpVisited" : [ ] }, "warpDate" : 1735593112612, "warpType" : "NORMAL", "warpCost" : null, "paid" : [ ], "banned" : [ ], "whitelisted" : [ ], "managers" : [ ], "whitelistEnabled" : false, "warpLocked" : false, "warpPassword" : null, "sponsorWarp" : null, "sponsorCooldown" : null, "randomSort" : 0, "warpPlayer" : { "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0", "messages" : [ ], "sponsorCooldown" : null, "staticWarps" : 0, "logs" : [ ], "earnedRateRewards" : [ ], "lastPlayed" : 1735593166489, "pendingWarp" : null, "maxWarpCostPrice" : 500.0, "minWarpCostPrice" : -1.0, "priceFreeLimit" : -1, "waitTeleportTime" : 3, "maximumWarps" : 9223372036854775807, "prettyMaximumWarps" : "Unlimited", "name" : "ForgotUrPassword", "language" : "en_gb" }, "favoriteCount" : 0, "warpDisplayName" : "testing2" }, { "id" : 52, "warpName" : "testing3", "warpLocation" : { "world" : "world", "x" : -1694.8984907026872, "y" : 86.65745599778442, "z" : -67.60435649154357, "yaw" : -22.475004, "pitch" : 43.49976, "locationSafe" : false, "warpServer" : "N/A", "properLocation" : { "world" : "world", "x" : -1694.8984907026872, "y" : 86.65745599778442, "z" : -67.60435649154357, "yaw" : -22.475004, "pitch" : 43.49976 }, "worldType" : "world" }, "warpRate" : { "earnedRateRewards" : [ ], "rates" : { }, "rateAverage" : 0.0, "totalRates" : 0, "playersRatedAmount" : 0 }, "warpCategory" : [ { "name" : "other", "teleportPrice" : -1.0, "purgeTime" : -1, "permission" : "", "removeDaysTime" : -1, "all" : false, "icon" : { "type" : "PAPER", "meta" : { "display-name" : "{\"text\":\"\",\"extra\":[{\"text\":\"Other Warps\",\"obfuscated\":false,\"italic\":false,\"underlined\":false,\"strikethrough\":false,\"color\":\"aqua\",\"bold\":false}]}", "lore" : [ "{\"text\":\"\",\"extra\":[{\"text\":\"Click\",\"color\":\"light_purple\"},{\"text\":\" to view all the other warps.\",\"color\":\"aqua\"}],\"italic\":false}" ], "PublicBukkitValues" : "{\n \"playerwarps:itemtag_item\": \"1\"\n}" } }, "displayName" : "Other" } ], "warpIcon" : { "warpIcon" : null }, "warpRent" : { "warpLastRent" : 1735593113763, "warpNewRent" : 1735679513763 }, "warpVisit" : { "warpVisits" : 0, "purgedWarpVisits" : 0, "warpVisitedBoosted" : [ ], "warpVisited" : [ ] }, "warpDate" : 1735593113763, "warpType" : "NORMAL", "warpCost" : null, "paid" : [ ], "banned" : [ ], "whitelisted" : [ ], "managers" : [ ], "whitelistEnabled" : false, "warpLocked" : false, "warpPassword" : null, "sponsorWarp" : null, "sponsorCooldown" : null, "randomSort" : 0, "warpPlayer" : { "uuid" : "5ca251ab-589d-4f04-8f0c-28404d0686b0", "messages" : [ ], "sponsorCooldown" : null, "staticWarps" : 0, "logs" : [ ], "earnedRateRewards" : [ ], "lastPlayed" : 1735593166491, "pendingWarp" : null, "maxWarpCostPrice" : 500.0, "minWarpCostPrice" : -1.0, "priceFreeLimit" : -1, "waitTeleportTime" : 3, "maximumWarps" : 9223372036854775807, "prettyMaximumWarps" : "Unlimited", "name" : "ForgotUrPassword", "language" : "en_gb" }, "favoriteCount" : 0, "warpDisplayName" : "testing3" } ], "totalPages" : 1, "currentPage" : 1, "totalWarps" : 3 } ``` **Fields:** * **warps** (Array of Warp objects): * **id** (Number): The ID of the warp. * **warpName** (String): The name of the warp. * **warpLocation** (Object): * **world** (String): The world of the warp. * **x** (Number): The X coordinate. * **y** (Number): The Y coordinate. * **z** (Number): The Z coordinate. * **yaw** (Number): The yaw of the location. * **pitch** (Number): The pitch of the location. * **locationSafe** (Boolean): Whether the location is safe. * **warpServer** (String): The server of the warp (if applicable). * **properLocation** (Object): * **world** (String): The world of the warp. * **x** (Number): The X coordinate. * **y** (Number): The Y coordinate. * **z** (Number): The Z coordinate. * **yaw** (Number): The yaw of the location. * **pitch** (Number): The pitch of the location. * **worldType** (String): The type of the world. * **warpRate** (Object): * **earnedRateRewards** (Array): List of rewards earned. * **rates** (Object): Contains rate information. * **rateAverage** (Number): The average rating. * **totalRates** (Number): Total number of ratings. * **playersRatedAmount** (Number): Number of players who rated. * **warpCategory** (Array of Objects): * **name** (String): Category name. * **teleportPrice** (Number): Price to teleport. * **purgeTime** (Number): Time until purge. * **permission** (String): Required permission. * **removeDaysTime** (Number): Time until removal. * **all** (Boolean): Whether it includes all warps. * **icon** (Object): * **type** (String): The type of the icon. * **meta** (Object): * **display-name** (String): The display name of the icon. * **lore** (Array of Strings): Lore description. * **PublicBukkitValues** (String): Custom Bukkit metadata. * **displayName** (String): Display name of the category. * **warpIcon** (Object): Warp icon details. * **warpRent** (Object): * **warpLastRent** (Number): Last rent timestamp. * **warpNewRent** (Number): New rent timestamp. * **warpVisit** (Object): * **warpVisits** (Number): Number of visits. * **purgedWarpVisits** (Number): Visits purged. * **warpVisitedBoosted** (Array): List of boosted visits. * **warpVisited** (Array): List of visits. * **warpDate** (Number): Warp creation date. * **warpType** (String): Type of the warp. * **warpCost** (Object): Cost details (if applicable). * **paid** (Array): List of paid players. * **banned** (Array): List of banned players. * **whitelisted** (Array): List of whitelisted players. * **managers** (Array): List of managers. * **whitelistEnabled** (Boolean): Whether whitelist is enabled. * **warpLocked** (Boolean): Whether the warp is locked. * **warpPassword** (String): Password for the warp (if applicable). * **sponsorWarp** (Object): Sponsor warp details. * **sponsorCooldown** (Object): Sponsor cooldown details. * **randomSort** (Number): Random sort value. * **warpPlayer** (Object): * **uuid** (String): Player's UUID. * **messages** (Array): Messages for the player. * **sponsorCooldown** (Object): Sponsor cooldown details. * **staticWarps** (Number): Number of static warps. * **logs** (Array): Logs related to the warp. * **earnedRateRewards** (Array): Rewards earned. * **lastPlayed** (Number): Last played timestamp. * **pendingWarp** (Object): Pending warp details. * **maxWarpCostPrice** (Number): Maximum cost for warp. * **minWarpCostPrice** (Number): Minimum cost for warp. * **priceFreeLimit** (Number): Free price limit. * **waitTeleportTime** (Number): Wait time for teleport. * **maximumWarps** (Number): Maximum number of warps. * **prettyMaximumWarps** (String): Human-readable maximum warps. * **name** (String): Player's name. * **language** (String): Player's language. * **favoriteCount** (Number): Number of favorites. * **warpDisplayName** (String): Display name of the warp. * **totalPages** (Number): Number of pages. * **currentPage** (Number): Current page. * **totalWarps** (Number): Total amount of warps on the server. **Note:** * [**Authentication**](https://docs.olziedev.com/projects/playerwarps/restapi/..#authentication) is required to access this endpoint. * Based on server settings, you may not be able to access warp information if you do not own the warp.