openapi: 3.0.3 info: title: Hypixel Public Housing SkyBlock API x-logo: url: https://api.hypixel.net/assets/images/logo.png altText: Hypixel Logo href: '#' description: "# Introduction\nThis is the official Hypixel API documentation. [Hypixel Website](https://hypixel.net/) - [GitHub Repo](https://github.com/HypixelDev/PublicAPI) - [API Help Forum](https://hypixel.net/forums/api-help.111/)\n\nAll use of the API must conform to the [API policies](https://developer.hypixel.net/policies), violation of these policies may lead to applications being revoked or users banned from the API.\n## Limits\nAPI keys are limited to a maximum amount of requests per 5 minute intervals. These limits will depend on the type of application that the key is assigned to.\n\nEndpoints which require the use of an API key will also respond with headers to assist with managing the rate limit:\n- 'RateLimit-Limit' - The limit of requests per minute for the provided API key.\n- 'RateLimit-Remaining' - The remaining amount of requests allowed for the current minute.\n- 'RateLimit-Reset' - The amount of seconds until the next minute and the reset of the API key usages.\n\n## GameTypes\n| ID | Type Name | Database Name | Clean Name |\n |----|----------------|---------------|----------------------|\n | 2 | QUAKECRAFT | Quake | Quake |\n | 3 | WALLS | Walls | Walls |\n | 4 | PAINTBALL | Paintball | Paintball |\n | 5 | SURVIVAL_GAMES | HungerGames | Blitz Survival Games |\n | 6 | TNTGAMES | TNTGames | TNT Games |\n | 7 | VAMPIREZ | VampireZ | VampireZ |\n | 13 | WALLS3 | Walls3 | Mega Walls |\n | 14 | ARCADE | Arcade | Arcade |\n | 17 | ARENA | Arena | Arena |\n | 20 | UHC | UHC | UHC Champions |\n | 21 | MCGO | MCGO | Cops and Crims |\n | 23 | BATTLEGROUND | Battleground | Warlords |\n | 24 | SUPER_SMASH | SuperSmash | Smash Heroes |\n | 25 | GINGERBREAD | GingerBread | Turbo Kart Racers |\n | 26 | HOUSING | Housing | Housing |\n | 51 | SKYWARS | SkyWars | SkyWars |\n | 52 | TRUE_COMBAT | TrueCombat | Crazy Walls |\n | 54 | SPEED_UHC | SpeedUHC | Speed UHC |\n | 55 | SKYCLASH | SkyClash | SkyClash |\n | 56 | LEGACY | Legacy | Classic Games |\n | 57 | PROTOTYPE | Prototype | Prototype |\n | 58 | BEDWARS | Bedwars | Bed Wars |\n | 59 | MURDER_MYSTERY | MurderMystery | Murder Mystery |\n | 60 | BUILD_BATTLE | BuildBattle | Build Battle |\n | 61 | DUELS | Duels | Duels |\n | 63 | SKYBLOCK | SkyBlock | SkyBlock |\n | 64 | PIT | Pit | Pit |\n | 65 | REPLAY | Replay | Replay |\n | 67 | SMP | SMP | SMP |\n | 68 | WOOL_GAMES | WoolGames | Wool Wars |\n\n### Storage\nGames store their respective stats and data in a Player's `stats` collection. The game's specific data is held within a JSON object named after it's `Database Name` (seen above.)\n### GameType Notes\n* Clean names are what is displayed to the user when referencing the name.\n* Database names or IDs are used when the API references a specific GameType.\n## Notes\n\n### Date and Time\nGenerally dates are stored as a Unix Epoch times in milliseconds.\n### Response Format\nResponses are served in JSON format.\n### UUID Parameters\nAll uuid parameters support both dashed and undashed versions.\n### SkyBlock items and inventories\nItems and inventory data are stored as a base64 encoded string containing gzipped nbt data.\nIf a method is missing important information about an item or inventory, you should try checking this!\n>Note: the base64 string may contain a unicode escape for non-alphabetical symbols, and some programming languages may have silent defects when interpreting the string. \n\n# Authentication\n\n" version: v2 termsOfService: https://hypixel.net/tos contact: name: Hypixel Support url: https://developer.hypixel.net x-jentic-source-url: https://api.hypixel.net/ x-generated-from: jentic-public-apis x-last-validated: '2026-05-30' servers: - url: https://api.hypixel.net security: - ApiKey: [] tags: - name: SkyBlock description: Hypixel SkyBlock — auctions, bazaar, profiles, museum, garden, bingo, fire sales, and SkyBlock-specific reference data. paths: /v2/resources/skyblock/collections: get: summary: Hypixel Collections description: Information regarding Collections in the SkyBlock game. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number version: type: string example: 0.11.22 collections: type: object examples: GetResourcesSkyblockCollections200Example: summary: Default getResourcesSkyblockCollections 200 response x-microcks-default: true value: success: true lastUpdated: 1.0 version: 0.11.22 collections: {} operationId: getResourcesSkyblockCollections x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/resources/skyblock/skills: get: summary: Hypixel Skills description: Information regarding skills in the SkyBlock game. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number version: type: string example: 0.11.22 skills: type: object examples: GetResourcesSkyblockSkills200Example: summary: Default getResourcesSkyblockSkills 200 response x-microcks-default: true value: success: true lastUpdated: 1.0 version: 0.11.22 skills: {} operationId: getResourcesSkyblockSkills x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/resources/skyblock/items: get: summary: Hypixel Items description: Information regarding items in the SkyBlock game. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number items: type: array items: $ref: '#/components/schemas/SkyBlockItem' examples: GetResourcesSkyblockItems200Example: summary: Default getResourcesSkyblockItems 200 response x-microcks-default: true value: success: true lastUpdated: 1.0 items: - example operationId: getResourcesSkyblockItems x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/resources/skyblock/election: get: summary: Hypixel Election and Mayor description: Information regarding the current mayor and ongoing election in SkyBlock. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number mayor: type: object description: Data regarding the current mayor current: type: object description: Data regarding the current election, will not be provided if there is no open election ongoing examples: GetResourcesSkyblockElection200Example: summary: Default getResourcesSkyblockElection 200 response x-microcks-default: true value: success: true lastUpdated: 1.0 mayor: {} current: {} operationId: getResourcesSkyblockElection x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/resources/skyblock/bingo: get: summary: Hypixel Current Bingo Event description: Information regarding the current bingo event and its goals. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object required: - success - lastUpdated - id - name - start - end - modifier - goals properties: success: type: boolean lastUpdated: type: number format: int64 description: The unix milliseconds timestamp of the last time this data was updated id: type: number format: int32 description: The current bingo event ID, increments by 1 for each bingo hosted example: 27 name: type: string description: The display name for the current bingo event example: March 2024 start: type: number format: int64 description: The start time of the current bingo event in unix milliseconds example: 1709269200000 end: type: number format: int64 description: The end time of the current bingo event in unix milliseconds example: 1709874000000 modifier: type: string enum: - NORMAL - EXTREME - SECRET description: The modifier for the current bingo event example: NORMAL goals: type: array description: The goals for the current bingo event, as well as their progress items: type: object required: - id - name properties: id: description: The backend ID for this goal type: string name: description: The user friendly display name for this goal type: string lore: description: Description of this goal type: string fullLore: description: The full description of this goal type: array tiers: description: The tiers of this goal, if a global goal type: array items: type: number format: int64 progress: description: The global progress of this goal type: number format: int64 requiredAmount: description: The required amount for this specific goal type: number format: int32 examples: GetResourcesSkyblockBingo200Example: summary: Default getResourcesSkyblockBingo 200 response x-microcks-default: true value: success: true lastUpdated: 1.0 id: 27 name: March 2024 start: 1709269200000 end: 1709874000000 operationId: getResourcesSkyblockBingo x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/news: get: summary: Hypixel News tags: - SkyBlock security: - ApiKey: [] responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean items: items: example: item: material: DIAMOND link: https://hypixel.net title: SkyBlock v0.11 text: 15th January 2021 examples: GetSkyblockNews200Example: summary: Default getSkyblockNews 200 response x-microcks-default: true value: success: true items: example '403': $ref: '#/components/responses/InvalidKey' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockNews x-microcks-operation: delay: 0 dispatcher: FALLBACK description: News /v2/skyblock/auction: get: summary: Hypixel Request Auction(s) by the Auction UUID, Player UUID, or Profile UUID. description: Returns the auctions selected by the provided query. Only one query parameter can be used in a single request, and cannot be filtered by multiple. tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: uuid description: The auction UUID that you wish to request schema: type: string example: ad8fefaa8351454bb739a4eaa872173f - in: query name: player description: The player UUID that you wish to request schema: type: string example: example - in: query name: profile description: The profile UUID that you wish to request schema: type: string example: a1b2c3d4-1234-5678-9abc-def012345678 responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean auctions: type: array items: $ref: '#/components/schemas/SkyBlockAuction' examples: GetSkyblockAuction200Example: summary: Default getSkyblockAuction 200 response x-microcks-default: true value: success: true auctions: - example '400': $ref: '#/components/responses/DataMissing' '403': $ref: '#/components/responses/InvalidKey' '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockAuction x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/auctions: get: summary: Hypixel Active Auctions description: Returns the currently active auctions sorted by last updated first and paginated. tags: - SkyBlock parameters: - in: query name: page schema: type: number default: 0 example: 0 description: The page parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean page: type: number totalPages: type: number example: 32 totalAuctions: type: number example: 31267 lastUpdated: type: number format: int64 example: 1571065561345 auctions: type: array items: $ref: '#/components/schemas/SkyBlockAuction' examples: GetSkyblockAuctions200Example: summary: Default getSkyblockAuctions 200 response x-microcks-default: true value: success: true page: 1.0 totalPages: 32 totalAuctions: 31267 lastUpdated: 1571065561345 auctions: - example '404': $ref: '#/components/responses/MissingPage' '422': $ref: '#/components/responses/InvalidPage' '503': $ref: '#/components/responses/NotPopulated' operationId: getSkyblockAuctions x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/auctions_ended: get: summary: Hypixel Recently Ended Auctions description: SkyBlock auctions which ended in the last 60 seconds. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number format: int64 example: 1607456463916 auctions: type: array items: example: auction_id: 015fe0c67e6041e69797bbe0c2725a21 seller: fc76242bf64a4698ae0ebc136d900929 seller_profile: 85b96cd3e73e4580b8379162ec059141 buyer: c1eff55de0d24ec6b44848799e9323ba buyer_profile: a3e1c076533a40a58085e7f43a598bf3 timestamp: 1607456400329 price: 190000 bin: true item_bytes: H4sIAAAAAAAAAEWR3W7TQBCFx2mBxKgtSH2ArUACZKL6L9jtndUYBdHQyGlV7qq1PXZX9U+03kB6yYNw7ffwo/AgiHEC4m7mmz1nz87qACPQhA4A2gAGItUGGjy5qNeV0nTYUzzX4PlNFUvkDzwuUNuD0Uyk+LHgeUOi3zo8S0WzKvjjCPYva4lDoofwsmu9KS95juesaxPDN+GY0FJJrHJ1v4PWxKTDAfGQy4rQB8M2WVKLqqHGy2RdsrKuGoWSPYiiaNjbS/yGBQ3RMo3+TF0Vj+/I5NXWj+2u7Acr0hCbmGbfbdWgd60/5xtmOBM4JPq5p9sofY43W4tfP3+wfyn/++Bfn+91nYJBxS0VlLQoMFGCIvYu6FnvXcenindtMQ++htMT8u11dPH1vWiYUFiyhFcsRiYxq2WO6Qm86NozUkRBFLLl7VU0HcL+F14iHNAg4rRuyYINgg5H4UZJHiglRbxW2AxhVEuRi+qa53CwnF0t7hY30cUsWIbD/jdBj4JP0zC6ozBkul4Teu34Tua7vj124tQduz73xtxOvbGVoZtMbN/xnIyMlSixUbxcwZFln/qn9DX2ue2wxRxgAE93q6b3wR9BYJa/RAIAAA== examples: GetSkyblockAuctionsEnded200Example: summary: Default getSkyblockAuctionsEnded 200 response x-microcks-default: true value: success: true lastUpdated: 1607456463916 auctions: - auction_id: 015fe0c67e6041e69797bbe0c2725a21 seller: fc76242bf64a4698ae0ebc136d900929 seller_profile: 85b96cd3e73e4580b8379162ec059141 buyer: c1eff55de0d24ec6b44848799e9323ba buyer_profile: a3e1c076533a40a58085e7f43a598bf3 timestamp: 1607456400329 price: 190000 bin: true item_bytes: H4sIAAAAAAAAAEWR3W7TQBCFx2mBxKgtSH2ArUACZKL6L9jtndUYBdHQyGlV7qq1PXZX9U+03kB6yYNw7ffwo/AgiHEC4m7mmz1nz87qACPQhA4A2gAGItUGGjy5qNeV0nTYUzzX4PlNFUvkDzwuUNuD0Uyk+LHgeUOi3zo8S0WzKvjjCPYva4lDoofwsmu9KS95juesaxPDN+GY0FJJrHJ1v4PWxKTDAfGQy4rQB8M2WVKLqqHGy2RdsrKuGoWSPYiiaNjbS/yGBQ3RMo3+TF0Vj+/I5NXWj+2u7Acr0hCbmGbfbdWgd60/5xtmOBM4JPq5p9sofY43W4tfP3+wfyn/++Bfn+91nYJBxS0VlLQoMFGCIvYu6FnvXcenindtMQ++htMT8u11dPH1vWiYUFiyhFcsRiYxq2WO6Qm86NozUkRBFLLl7VU0HcL+F14iHNAg4rRuyYINgg5H4UZJHiglRbxW2AxhVEuRi+qa53CwnF0t7hY30cUsWIbD/jdBj4JP0zC6ozBkul4Teu34Tua7vj124tQduz73xtxOvbGVoZtMbN/xnIyMlSixUbxcwZFln/qn9DX2ue2wxRxgAE93q6b3wR9BYJa/RAIAAA== operationId: getSkyblockAuctionsEnded x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/bazaar: get: summary: Hypixel Bazaar description: "Returns the list of products along with their sell summary, buy summary and quick status.\n ### Product Description\n The returned product info has 3 main fields:\n - `buy_summary`\n - `sell_summary`\n - `quick_status`\n\n`buy_summary` and `sell_summary` are the current top 30 orders for each transaction type (in-game example: [Stock of Stonks](https://i.imgur.com/SjRONxq.png)).\n\n`quick_status` is a computed summary of the live state of the product (used for advanced mode view in the bazaar):\n- `sellVolume` and `buyVolume` are the sum of item amounts in all orders.\n - `sellPrice` and `buyPrice` are the weighted average of the top 2% of orders by volume.\n - `movingWeek` is the historic transacted volume from last 7d + live state.\n - `sellOrders` and `buyOrders` are the count of active orders. " tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean lastUpdated: type: number format: int64 example: 1590854517479 products: type: object example: INK_SACK:3: product_id: INK_SACK:3 sell_summary: - amount: 20569 pricePerUnit: 4.2 orders: 1 - amount: 140326 pricePerUnit: 3.8 orders: 2 buy_summary: - amount: 640 pricePerUnit: 4.8 orders: 1 - amount: 640 pricePerUnit: 4.9 orders: 1 - amount: 25957 pricePerUnit: 5 orders: 3 quick_status: productId: INK_SACK:3 sellPrice: 4.2 sellVolume: 409855 sellMovingWeek: 8301075 sellOrders: 11 buyPrice: 4.99260315136572 buyVolume: 1254854 buyMovingWeek: 5830656 buyOrders: 85 examples: GetSkyblockBazaar200Example: summary: Default getSkyblockBazaar 200 response x-microcks-default: true value: success: true lastUpdated: 1590854517479 products: INK_SACK:3: product_id: INK_SACK:3 sell_summary: - amount: 20569 pricePerUnit: 4.2 orders: 1 - amount: 140326 pricePerUnit: 3.8 orders: 2 buy_summary: - amount: 640 pricePerUnit: 4.8 orders: 1 - amount: 640 pricePerUnit: 4.9 orders: 1 - amount: 25957 pricePerUnit: 5 orders: 3 quick_status: productId: INK_SACK:3 sellPrice: 4.2 sellVolume: 409855 sellMovingWeek: 8301075 sellOrders: 11 buyPrice: 4.99260315136572 buyVolume: 1254854 buyMovingWeek: 5830656 buyOrders: 85 '503': $ref: '#/components/responses/NotPopulated' operationId: getSkyblockBazaar x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/profile: get: summary: Hypixel Profile by UUID description: SkyBlock profile data, such as stats, objectives etc. The data returned can differ depending on the players in-game API settings. tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: profile schema: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f description: The profile parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean profile: $ref: '#/components/schemas/SkyBlockProfile' examples: GetSkyblockProfile200Example: summary: Default getSkyblockProfile 200 response x-microcks-default: true value: success: true profile: a1b2c3d4-1234-5678-9abc-def012345678 '400': $ref: '#/components/responses/DataMissing' '403': $ref: '#/components/responses/InvalidKey' '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockProfile x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/profiles: get: summary: Hypixel Profiles by Player tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: uuid schema: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f description: The uuid parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean profiles: type: array items: $ref: '#/components/schemas/SkyBlockProfile' examples: GetSkyblockProfiles200Example: summary: Default getSkyblockProfiles 200 response x-microcks-default: true value: success: true profiles: - a1b2c3d4-1234-5678-9abc-def012345678 '400': $ref: '#/components/responses/DataMissing' '403': $ref: '#/components/responses/InvalidKey' '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockProfiles x-microcks-operation: delay: 0 dispatcher: FALLBACK description: Profiles by player /v2/skyblock/museum: get: summary: Hypixel Museum Data by Profile ID description: SkyBlock museum data for all members of the provided profile. The data returned can differ depending on the players in-game API settings. tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: profile schema: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f description: The profile parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean profile: $ref: '#/components/schemas/SkyBlockMuseum' examples: GetSkyblockMuseum200Example: summary: Default getSkyblockMuseum 200 response x-microcks-default: true value: success: true profile: a1b2c3d4-1234-5678-9abc-def012345678 '403': $ref: '#/components/responses/InvalidKey' '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockMuseum x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/garden: get: summary: Hypixel Garden Data by Profile ID description: SkyBlock garden data for the provided profile. tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: profile schema: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f description: The profile parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean garden: $ref: '#/components/schemas/SkyBlockGarden' examples: GetSkyblockGarden200Example: summary: Default getSkyblockGarden 200 response x-microcks-default: true value: success: true garden: example '403': $ref: '#/components/responses/InvalidKey' '404': $ref: '#/components/responses/NoResult' '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockGarden x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/bingo: get: summary: Hypixel Bingo Data by Player description: Bingo data for participated events of the provided player. tags: - SkyBlock security: - ApiKey: [] parameters: - in: query name: uuid schema: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f description: The uuid parameter. responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean events: type: array items: type: object required: - key - points - completed_goals properties: key: description: The id for this event type: number format: int32 example: 2 points: description: The amount of points earned type: number format: int32 example: 117 completed_goals: description: The completed goal IDs type: array items: type: string example: - stat_walk_speed - KILL_TRAPPER_MOB examples: GetSkyblockBingo200Example: summary: Default getSkyblockBingo 200 response x-microcks-default: true value: success: true events: - key: 2 points: 117 completed_goals: - - stat_walk_speed - KILL_TRAPPER_MOB '400': $ref: '#/components/responses/DataMissing' '403': $ref: '#/components/responses/InvalidKey' '404': description: No data could be found for the provided player uuid. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: No bingo data could be found examples: GetSkyblockBingo404Example: summary: Default getSkyblockBingo 404 response x-microcks-default: true value: success: false cause: No bingo data could be found '422': $ref: '#/components/responses/MalformedData' '429': $ref: '#/components/responses/RateLimited' operationId: getSkyblockBingo x-microcks-operation: delay: 0 dispatcher: FALLBACK /v2/skyblock/firesales: get: summary: Hypixel Active/Upcoming Fire Sales description: Retrieve the currently active or upcoming Fire Sales for SkyBlock. tags: - SkyBlock responses: '200': description: A successful response content: application/json: schema: type: object properties: success: type: boolean sales: type: array items: $ref: '#/components/schemas/SkyBlockFireSale' examples: GetSkyblockFiresales200Example: summary: Default getSkyblockFiresales 200 response x-microcks-default: true value: success: true sales: - example operationId: getSkyblockFiresales x-microcks-operation: delay: 0 dispatcher: FALLBACK components: responses: InvalidKey: description: Access is forbidden, usually due to an invalid API key being used. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Invalid API key NotPopulated: description: The data is not yet populated and should be available shortly content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Leaderboard data has not yet been populated NoResult: description: The request responded with no result. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: No result was found MissingPage: description: The page provided does not exist. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Page not found RateLimited: description: A request limit has been reached, usually this is due to the limit on the key being reached but can also be triggered by a global throttle. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Key throttle throttle: type: boolean example: true global: type: boolean description: When this boolean exists and is true, the throttle occurring is a global throttle applied to all users example: true MalformedData: description: Some data provided is invalid. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Malformed UUID InvalidPage: description: The page provided is invalid. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Invalid page DataMissing: description: Some data is missing, this is usually a field. content: application/json: schema: type: object properties: success: type: boolean example: false cause: type: string example: Missing one or more fields [...] schemas: SkyBlockFireSale: properties: item_id: description: The SkyBlock item ID for this sale type: string example: '500123' start: description: The start time in unix milliseconds for the sale type: number example: 1.0 end: description: The end time in unix milliseconds for the sale type: number example: 1.0 amount: description: The amount of items available for this sale type: integer example: 42 price: description: The price in Gems for this sale type: integer example: 42 SkyBlockItem: properties: id: description: The unique identifier for this item type: string example: '500123' material: description: The Bukkit material enum value for the item type: string example: example name: description: The name of the item type: string example: ExamplePlayer tier: description: The rarity tier of the item type: string enum: - COMMON - UNCOMMON - RARE - EPIC - LEGENDARY - MYTHIC - SUPREME - SPECIAL - VERY_SPECIAL example: COMMON color: description: The color metadata to be applied to an item, usually leather armor pieces pattern: ^(?:(?:^|,\s*)([01]?\d\d?|2[0-4]\d|25[0-5])){3}$ type: string example: example skin: description: The skin value for a skull based item type: string example: example example: material: LEATHER_CHESTPLATE color: 255,215,0 name: Farm Armor Chestplate category: CHESTPLATE tier: RARE stats: DEFENSE: 75 HEALTH: 20 npc_sell_price: 5200 id: FARM_ARMOR_CHESTPLATE SkyBlockMuseum: properties: value: type: integer format: int64 example: 1748544600000 appraisal: type: boolean example: true items: type: object special: type: array properties: donated_time: type: integer format: int64 example: 1748544600000 items: type: object SkyBlockProfile: properties: profile_id: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f members: description: A map of member UUIDs to member profiles objects type: object properties: player_id: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f profile: type: object properties: deletion_notice: description: If this field exists, the member profile is marked as deleted nullable: true type: object properties: timestamp: type: integer format: int64 example: 1748544600000 cute_name: description: The cute name of the profile, only provided on the profiles endpoint nullable: true type: string example: ExamplePlayer selected: description: Whether or not this is the currently selected profile, only provided on the profiles endpoint nullable: true type: boolean example: true community_upgrades: nullable: true type: object banking: description: Information about the bank account for this profile, only present if the API banking setting is enabled nullable: true type: object properties: balance: type: number format: double example: 1.0 transactions: type: array items: type: object properties: timestamp: type: integer format: int64 example: 1748544600000 action: type: string enum: - DEPOSIT - WITHDRAW example: DEPOSIT initiator_name: type: string example: ExamplePlayer amount: type: number format: double example: 1.0 game_mode: description: The SkyBlock game mode of the profile, not present if normal mode nullable: true type: string enum: - ironman - island - bingo example: ironman SkyBlockGarden: description: Information about a player's SkyBlock garden, the only guaranteed field is the `uuid` field. required: - uuid properties: uuid: type: string format: uuid description: The UUID of the profile for this garden. example: ad8fefaa8351454bb739a4eaa872173f commission_data: type: object properties: visits: type: object description: A map of visitor identifier to visit count example: jerry: 1 jacob: 2 andrew: 3 completed: type: object description: A map of visitor identifier to completed count example: jerry: 1 jacob: 1 andrew: 2 total_completed: type: integer format: int32 example: 42 unique_npcs_served: type: integer format: int32 example: 42 composter_data: type: object example: organic_matter: 1772.8 fuel_units: 17000 compost_units: 0 compost_items: 2 conversion_ticks: 300 last_save: 1721039418436 upgrades: speed: 25 multi_drop: 25 fuel_cap: 22 organic_matter_cap: 25 cost_reduction: 25 active_commissions: type: object example: liam: requirement: - original_item: NETHER_STALK original_amount: 93995 item: MUTANT_NETHER_STALK amount: 4 status: NOT_STARTED position: 1 lumberjack: requirement: - original_item: POTATO_ITEM original_amount: 81380 item: ENCHANTED_BAKED_POTATO amount: 3 status: NOT_STARTED position: 2 oringo: requirement: - original_item: WHEAT original_amount: 26798 item: ENCHANTED_HAY_BLOCK amount: 21 status: NOT_STARTED position: 3 rhys: requirement: - original_item: JACK_O_LANTERN original_amount: 512 item: JACK_O_LANTERN amount: 512 status: NOT_STARTED position: 4 fear_mongerer: requirement: - original_item: PUMPKIN original_amount: 27709 item: POLISHED_PUMPKIN amount: 1 status: NOT_STARTED position: 5 extra_rewards: - candy: PURPLE_CANDY resources_collected: type: object description: A map of resource ID to amount collected example: WHEAT: 100 POTATO_ITEM: 100 INK_SACK:3: 100 crop_upgrade_levels: type: object example: WHEAT: 1 POTATO_ITEM: 2 INK_SACK:3: 3 unlocked_plots_ids: type: array items: type: string example: - beginner_1 - intermediate_3 garden_experience: type: integer format: double example: 42 unlocked_barn_skins: type: array items: type: string selected_barn_skin: type: string example: example SkyBlockAuction: properties: _id: type: string format: objectid example: 5fcbf9d9d295e80a766f3b14 uuid: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f auctioneer: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f profile_id: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f coop: type: array items: type: string format: uuid start: type: number format: int64 example: 1.0 end: type: number format: int64 example: 1.0 item_name: type: string example: ExamplePlayer item_lore: type: string example: example extra: type: string example: example category: type: string example: example tier: type: string example: example starting_bid: type: number example: 1.0 item_bytes: type: object properties: type: type: number example: 1.0 data: type: string example: example claimed: type: boolean example: true claimed_bidders: type: array highest_bid_amount: type: number example: 1.0 bids: type: array items: type: object properties: auction_id: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f bidder: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f profile_id: type: string format: uuid example: ad8fefaa8351454bb739a4eaa872173f amount: type: number example: 1.0 timestamp: type: number format: int64 example: 1.0 example: uuid: 409a1e0f261a49849493278d6cd9305a auctioneer: 347ef6c1daac45ed9d1fa02818cf0fb6 profile_id: 347ef6c1daac45ed9d1fa02818cf0fb6 coop: - 347ef6c1daac45ed9d1fa02818cf0fb6 start: 1573760802637 end: 1573761102637 item_name: Azure Bluet item_lore: §f§lCOMMON extra: Azure Bluet Red Rose category: blocks tier: COMMON starting_bid: 1 item_bytes: type: 0 data: H4sIAAAAAAAAAB2NQQqCQBhGv1ErHaKu0KoLtGtnarRIhTpA/OGfDIwZ4wxUF/IeHiyyto/3eBKIIJQEIDx4qsJaYJK07m6FhG+p9hEdVMV7TXU3Wh+JWaW6h6ZXhODYGg5/LeZDfxt6nZR5XhYhgoIaxmKE8dsZXu20YwuJZfa0hmJrjbo6y134f8pTll5O5TnbbgAP05Qaqhk+8AVIrd2eoAAAAA== claimed: true claimed_bidders: [] highest_bid_amount: 7607533 bids: - auction_id: 409a1e0f261a49849493278d6cd9305a bidder: 99748e629dee463892f68abf3a780094 profile_id: 99748e629dee463892f68abf3a780094 amount: 7607533 timestamp: 1573760824844 securitySchemes: ApiKey: type: apiKey in: header name: API-Key description: Obtained via the [Hypixel Developer Dashboard](https://developer.hypixel.net) when creating an application. You can also request higher limits for production applications in this dashboard.