/api/v1/items/{id}

Single item by ID or name slug

• id (path, required) — Item ID or slug (e.g. "diamond-sword")

/api/v1/mobs

All 76 Minecraft mobs with stats, drops, behavior

• search (query) — Partial name match, case‑insensitive
• type (query) — Exact mob type (passive, neutral, hostile, boss)
• category (query) — Exact mob category (same values as type)

/api/v1/mobs/{id}

Single mob by ID or name slug

• id (path, required) — Mob ID or slug (e.g. "creeper", "cave-spider")

/api/v1/biomes

All 64 biomes with terrain, colors, spawns

• search (query) — Partial biome name match, case‑insensitive
• dimension (query) — Exact dimension (overworld, nether, end)
• category (query) — Exact biome category (temperate, cold, warm, ocean, underground, beach_special, nether, end)
• rarity (query) — Exact rarity (common, uncommon, rare, very_rare)

/api/v1/biomes/{name}

Single biome by ID or name slug

• name (path, required) — Biome ID or slug (e.g. "cherry-grove", "minecraft:plains")

/api/v1/items

100 items with crafting recipes, stats, enchantments

• search (query) — Partial item name match, case‑insensitive
• category (query) — Exact item category (tool, weapon, armor, food, block, redstone, potion, music_disc, transportation, miscellaneous)

/api/v1/enchantments

40 enchantments with levels, compatibility, effects

• search (query) — Partial enchantment name match, case‑insensitive
• category (query) — Exact category (melee, ranged, mining, armor, universal, special)

/api/v1/enchantments/{id}

Single enchantment by ID or name slug

• id (path, required) — Enchantment ID or slug (e.g. "sharpness")

/api/v1/structures

24 structures with loot tables, locations, dangers

• search (query) — Partial structure name match, case‑insensitive
• dimension (query) — Exact dimension (overworld, nether, end)
• category (query) — Exact structure category (overworld_surface, overworld_underground, ocean, nether, end)
• rarity (query) — Exact rarity (common, uncommon, rare, very_rare, unique)

/api/v1/structures/{id}

Single structure by ID or name slug

• id (path, required) — Structure ID or slug (e.g. "village", "nether-fortress")

/api/v1/commands

57 commands with syntax, params, examples

• search (query) — Partial command name match, case‑insensitive
• category (query) — Exact command category (player, world, server, data, display, logic, gameplay, special, time_weather, bossbar, execute)
• permissionLevel (query) — Exact permission level (0, 2, 3, 4)

/api/v1/commands/{name}

Single command by name

• name (path, required) — Command name without leading slash (e.g. "give")

/api/v1/versions

36 version entries with features and changelogs

• search (query) — Partial name or update name match, case‑insensitive
• type (query) — Exact type (major-release, minor-release)
• edition (query) — Exact edition (java)

/api/v1/versions/{slug}

Single version by slug (e.g. 1-21)

• slug (path, required) — Version slug (numeric or hyphenated, e.g. "1-21")

/api/v1/achievements

111 advancements with tabs, difficulty, rewards

• search (query) — Partial achievement name match, case‑insensitive
• tab (query) — Exact tab (minecraft, nether, end, adventure, husbandry)
• difficulty (query) — Exact difficulty (easy, medium, hard, expert)

/api/v1/achievements/{slug}

Single achievement by slug

• slug (path, required) — Achievement slug (e.g. "adventure-time")

/api/v1/trades

All villager professions with full trade tables

• search (query) — Partial profession name match, case‑insensitive

/api/v1/trades/{id}

Single profession trade data by ID

• id (path, required) — Profession ID or slug (e.g. "librarian")

/api/health

API health check