Hypixel Resources API

Static reference data — games, achievements, challenges, quests, guild achievements, vanity pets and companions.

Operations 7

GET /v2/resources/games Hypixel Game Information #
GET /v2/resources/achievements Hypixel Achievements #
GET /v2/resources/challenges Hypixel Challenges #
GET /v2/resources/quests Hypixel Quests #
GET /v2/resources/guilds/achievements Hypixel Guild Achievements #
GET /v2/resources/vanity/pets Hypixel Vanity Pets #
GET /v2/resources/vanity/companions Hypixel Vanity Companions #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/hypixel-resources-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

hypixel-resources-api-openapi.yml Raw ↑
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.