{"name":"PalToolkit Palworld API","api_version":"v1","version":"1.0.0","game_version":"1.0.5","steam_build_id":"25247047","data_updated":"2026-09-29","generated_at":"2026-10-23","docs":"https://paltoolkit.com/api/","base_url":"https://paltoolkit.com/api/v1","schema":"https://paltoolkit.com/api/v1/schema.json","client":"https://paltoolkit.com/api/v1/paltoolkit.js","license":{"id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/","attribution":"Data by PalToolkit (paltoolkit.com)","note":"Our compilation and computed data are CC BY 4.0: credit \"Data by PalToolkit (paltoolkit.com)\" with a link. Upstream MIT notices are listed in sources and must be kept. Game data and images (c) Pocketpair, Inc.; images are not licensed by us."},"counts":{"pals":300,"breedable_pals":299,"items":1492,"passives":115,"skills":320,"elements":9,"pairs":44850,"unique_recipes":136,"merchants":26},"endpoints":[{"path":"/api/v1/index.json","url":"https://paltoolkit.com/api/v1/index.json","description":"API index: version, licence, sources, endpoints","sources":["paltoolkit"]},{"path":"/api/v1/pals.json","url":"https://paltoolkit.com/api/v1/pals.json","description":"All Pals (list): elements, rarity, work, base stats, image, page URL","sources":["palcalc","palworld_atlas_data","paledit","palworld_knowledge","paltoolkit"]},{"path":"/api/v1/pals/{slug}.json","url":"https://paltoolkit.com/api/v1/pals/{slug}.json","description":"One Pal: stats, movement, work, skills, passives, egg, spawns, alpha, breeding summary","sources":["palcalc","palworld_atlas_data","paledit","palworld_knowledge","paltoolkit"]},{"path":"/api/v1/breeding.json","url":"https://paltoolkit.com/api/v1/breeding.json","description":"Breeding rule, special recipes, inheritance weights, combo count + earliest pair per child","sources":["paltoolkit","palcalc"]},{"path":"/api/v1/breeding/{child}.json","url":"https://paltoolkit.com/api/v1/breeding/{child}.json","description":"Every parent pair for one child, earliest first","sources":["paltoolkit","palcalc"]},{"path":"/api/v1/breeding/matrix.json","url":"https://paltoolkit.com/api/v1/breeding/matrix.json","description":"Compact child-of-pair matrix for local lookups (any pair)","sources":["paltoolkit","palcalc"]},{"path":"/api/v1/items.json","url":"https://paltoolkit.com/api/v1/items.json","description":"All items (list): category, rarity, price, stack size","sources":["palworld_atlas_data","paldex","paltoolkit"]},{"path":"/api/v1/items/{slug}.json","url":"https://paltoolkit.com/api/v1/items/{slug}.json","description":"One item: + merchants selling it, skill fruit / implant links, egg hatches","sources":["palworld_atlas_data","paldex","paltoolkit"]},{"path":"/api/v1/passives.json","url":"https://paltoolkit.com/api/v1/passives.json","description":"Passive skills: rank, effects, how to get them, Pals that have them innately","sources":["palcalc","palworld_knowledge"]},{"path":"/api/v1/skills.json","url":"https://paltoolkit.com/api/v1/skills.json","description":"Active skills: element, power, cooldown, who learns them at which level","sources":["palcalc"]},{"path":"/api/v1/elements.json","url":"https://paltoolkit.com/api/v1/elements.json","description":"Elements: strong against, weak to, Pals per element","sources":["palcalc","palworld_atlas_data","paltoolkit"]},{"path":"/api/v1/work.json","url":"https://paltoolkit.com/api/v1/work.json","description":"Work suitability: Pals per job with level","sources":["palcalc","palworld_atlas_data","paledit","palworld_knowledge","paltoolkit"]},{"path":"/api/v1/eggs.json","url":"https://paltoolkit.com/api/v1/eggs.json","description":"Eggs: which Pals hatch from each, wild egg spawn counts","sources":["palworld_atlas_data","pal_atlas","paltoolkit"]},{"path":"/api/v1/bosses.json","url":"https://paltoolkit.com/api/v1/bosses.json","description":"Alpha, bounty and tower bosses with level and map coordinates","sources":["paldex","palworld_atlas_data","palworld_knowledge"]},{"path":"/api/v1/collectibles.json","url":"https://paltoolkit.com/api/v1/collectibles.json","description":"Collectible types and counts; effigy types","sources":["paldex","pal_atlas"]},{"path":"/api/v1/collectibles/{type}.json","url":"https://paltoolkit.com/api/v1/collectibles/{type}.json","description":"Map points of one type: effigies, journals, schematics, egg-spawns, chests, skill-fruit-trees, oil-rigs, npcs","sources":["paldex","pal_atlas"]},{"path":"/api/v1/merchants.json","url":"https://paltoolkit.com/api/v1/merchants.json","description":"Merchants: location, currency, items sold, Pal dealers' pools","sources":["paldex"]},{"path":"/api/v1/schema.json","url":"https://paltoolkit.com/api/v1/schema.json","description":"JSON Schema (draft 2020-12) for every endpoint","sources":["paltoolkit"]},{"path":"/api/v1/paltoolkit.js","url":"https://paltoolkit.com/api/v1/paltoolkit.js","description":"Dependency-free ES module client","sources":["paltoolkit"]}],"sources":{"paltoolkit":{"name":"PalToolkit","url":"https://paltoolkit.com/about/","license":"CC-BY-4.0","copyright":"PalToolkit","used_for":"breeding results and pair lists (our engine, checked pair by pair against palcalc), earliest pairs, egg per Pal (element + rarity rule), spawn summaries, damage multipliers, Lv 80 stat ranges, slugs and URLs"},"palcalc":{"name":"palcalc","url":"https://github.com/tylercamp/palcalc","license":"MIT","copyright":"Copyright 2024, Tyler Camp","used_for":"Pal names, stats, combi rank, work levels, active skills, passive skills, unique breeding combos, inheritance weights"},"palworld_atlas_data":{"name":"palworld-atlas-data","url":"https://github.com/Awy64/palworld-atlas-data","license":"MIT","copyright":"Copyright (c) 2026 Adam Young","used_for":"elements, gear, wild + alpha spawn points and levels, item table (id, name, category, rarity, price, stack)"},"paledit":{"name":"PalEdit","url":"https://github.com/EternalWraith/PalEdit","license":"MIT","copyright":"Copyright (c) 2024 Jacob Lawrence","used_for":"support and work-speed stats, Oil Extraction level, Terraria Pal elements"},"palworld_knowledge":{"name":"palworld-knowledge","url":"https://github.com/GGarnize/palworld-knowledge","license":"MIT","copyright":"Copyright (c) 2026 GGarnize","used_for":"movement speeds, alpha natural passives, passive availability and effects"},"paldex":{"name":"PalDex","url":"https://github.com/catrenelle/PalDex","license":"MIT","copyright":"Copyright (c) 2026 Catherine Renelle","used_for":"alpha + bounty bosses, towers, oil rigs, effigies, journals, schematics, NPCs, merchants"},"pal_atlas":{"name":"pal-atlas","url":"https://github.com/Nifrendil/pal-atlas","license":"MIT","copyright":"Copyright (c) 2026 Ryexha, JenAri","used_for":"egg spawn spots, chests, skill-fruit trees"},"pocketpair":{"name":"Palworld (Pocketpair, Inc.)","url":"https://www.pocketpair.jp/","license":"game data and art (c) Pocketpair, Inc.","copyright":"Palworld (c) Pocketpair, Inc.","used_for":"all underlying game facts; images linked by URL are game art, not covered by the data licence"}},"excluded":[{"field":"pals.partner_skill","why":"only source is palworld.kimpton.io (no licence stated)"},{"field":"pals.drops","why":"only source is palworld.kimpton.io (no licence stated)"},{"field":"pals.genus, pals.stats.melee, pals.ranch, pals.boss_locations","why":"palworld.kimpton.io gap-fill"},{"field":"pals.capture_rate, pals.trust, pals.predator, pals.exp_ratio","why":"palworld-save-pal (GPL-3.0) facts"},{"field":"items.recipe, items.stats, items.weight, items.drop_sources, items.tiers, items.ammo","why":"palworld.kimpton.io item pages"},{"field":"technology, structures","why":"palworld-save-pal (GPL-3.0) facts"},{"field":"collectibles: kinship_peach, enemy_camps, effigy rank costs","why":"palworld-save-pal (GPL-3.0) facts"},{"field":"near (closest place name), u/v (map-image fractions)","why":"derived from palworld.kimpton.io map markers / our map art"},{"field":"images","why":"Palworld art (c) Pocketpair: linked by URL on paltoolkit.com, never embedded, not covered by the data licence"}],"changelog":[{"version":"1.0.0","date":"2026-10-01","changes":"First public release: Pals, breeding (per child + full matrix), items, passive skills, active skills, elements, eggs, bosses, collectibles, merchants, JS client. pals.json lists the full Paldeck; Astralym (#204) has breeding_class \"none\" and is not in the matrix."}],"versioning":"v1 is frozen in shape: fields are only added, never renamed or removed. A breaking change ships as /api/v2/ and v1 stays online for at least 6 months. Data refreshes with each game patch (see data_updated and game_version).","disclaimer":"PalToolkit is an unofficial fan site. Palworld is a trademark of Pocketpair, Inc. Not affiliated with or endorsed by Pocketpair."}