Hypixel Resources API
Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.
Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/hypixel-resources-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Hypixel Public Resources API
x-logo:
url: https://api.hypixel.net/assets/images/logo.png
altText: Hypixel Logo
href: '#'
description: '# Introduction
This is the official Hypixel API documentation.'
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: Resources
description: Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.
paths:
/v2/resources/games:
get:
summary: Hypixel Game Information
description: Returns information about Hypixel Games. This endpoint is in early development and we are working to add more information when possible HypixelDev/PublicAPI#197
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
games:
type: object
description: A map where the key is the backend name of the game
additionalProperties:
$ref: '#/components/schemas/Game'
examples:
GetResourcesGames200Example:
summary: Default getResourcesGames 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
games: {}
operationId: getResourcesGames
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/v2/resources/achievements:
get:
summary: Hypixel Achievements
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
achievements:
type: object
examples:
GetResourcesAchievements200Example:
summary: Default getResourcesAchievements 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
achievements: {}
operationId: getResourcesAchievements
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Achievements
/v2/resources/challenges:
get:
summary: Hypixel Challenges
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
challenges:
type: object
examples:
GetResourcesChallenges200Example:
summary: Default getResourcesChallenges 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
challenges: {}
operationId: getResourcesChallenges
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Challenges
/v2/resources/quests:
get:
summary: Hypixel Quests
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
quests:
type: object
examples:
GetResourcesQuests200Example:
summary: Default getResourcesQuests 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
quests: {}
operationId: getResourcesQuests
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Quests
/v2/resources/guilds/achievements:
get:
summary: Hypixel Guild Achievements
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
one_time:
type: object
tiered:
type: object
examples:
GetResourcesGuildsAchievements200Example:
summary: Default getResourcesGuildsAchievements 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
one_time: {}
tiered: {}
operationId: getResourcesGuildsAchievements
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Guild Achievements
/v2/resources/vanity/pets:
get:
summary: Hypixel Vanity Pets
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
types:
type: object
rarities:
type: object
examples:
GetResourcesVanityPets200Example:
summary: Default getResourcesVanityPets 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
types: {}
rarities: {}
operationId: getResourcesVanityPets
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Vanity Pets
/v2/resources/vanity/companions:
get:
summary: Hypixel Vanity Companions
tags:
- Resources
responses:
'200':
description: A successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
lastUpdated:
type: number
types:
type: object
rarities:
type: object
examples:
GetResourcesVanityCompanions200Example:
summary: Default getResourcesVanityCompanions 200 response
x-microcks-default: true
value:
success: true
lastUpdated: 1.0
types: {}
rarities: {}
operationId: getResourcesVanityCompanions
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
description: Vanity Companions
components:
schemas:
Game:
description: Information about a specific game. When a field is not present you should fallback to the provided default if there is one, required fields will always exist.
required:
- id
- name
- databaseName
properties:
id:
type: integer
description: The backend ID of the game.
example: 1
name:
type: string
description: The display name of the game.
example: Bed Wars
databaseName:
type: string
description: The key used for database storage, such as for stats.
example: Bedwars
modeNames:
type: object
description: A map of mode key to display name
example:
solo_normal: Solo
team_normal: Doubles
retired:
type: boolean
description: True if the game is retired and no longer playable.
default: false
example: false
legacy:
type: boolean
description: True if the game is legacy and part of the Classic Lobby.
default: false
example: false
example:
id: 58
name: Bed Wars
databaseName: Bedwars
modeNames:
BEDWARS_TWO_FOUR: 4v4
BEDWARS_EIGHT_ONE: Solo
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.