lily dexAPI Documentation
The lily dex API provides Pokemon GO game data as static JSON files, updated automatically every 6 hours. Data is aggregated from PokeMiners Game Master, PvPoke, the Pokemon GO API, and the GO Calendar.
https://mknepprath.github.io/lily-dex-apiPokedex
GEThttps://mknepprath.github.io/lily-dex-api/pokedex.jsonComplete Pokemon GO Pokedex with stats, moves, types, evolutions, forms, buddy distance, PvP IVs, and sprite URLs.
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Pokemon species ID (e.g. BULBASAUR) |
formId | string | Form identifier |
dexNr | number | National Pokedex number |
generation | number | Generation (1-9) |
names | object | Localized names (English, Japanese, Korean, etc.) |
stats | object | Base stats: { stamina, attack, defense } |
primaryType | object | Primary type with localized names |
secondaryType | object | null | Secondary type, if any |
pokemonClass | string | null | LEGENDARY, MYTHIC, or ULTRA_BEAST |
quickMoves | object | Available fast moves with stats and PvP data |
cinematicMoves | object | Available charged moves with stats and PvP data |
eliteQuickMoves | object | [] | Elite TM fast moves |
eliteCinematicMoves | object | [] | Elite TM charged moves |
evolutions | array | Evolution branches with candy, items, buddy distance, time-of-day, gender, lure, and trade requirements |
regionForms | object | [] | Alolan, Galarian, Hisuian, Paldean forms with their own stats and moves |
megaEvolutions | array | Mega evolution stats and type overrides |
buddyDistance | number | Buddy walk distance in km |
thirdMoveCost | number | null | Stardust cost for second charged move |
defaultIVs | object | null | Optimal PvP IVs per league (cp500, cp1500, cp2500) |
assets | object | Official artwork URLs (image, shinyImage) |
pixelSprites | object | Pixel sprite URLs (image, shinyImage) |
Example
curl https://mknepprath.github.io/lily-dex-api/pokedex.jsonPvP Rankings
GEThttps://mknepprath.github.io/lily-dex-api/rankings.jsonTop 100 ranked Pokemon for Great League (1500 CP), Ultra League (2500 CP), and Master League with recommended movesets, matchups, and counters. Sourced from PvPoke.
Response Fields
| Field | Type | Description |
|---|---|---|
great | array | Great League top 100 |
ultra | array | Ultra League top 100 |
master | array | Master League top 100 |
Ranking Entry Fields
| Field | Type | Description |
|---|---|---|
rank | number | Ranking position (1-100) |
speciesId | string | PvPoke species ID |
speciesName | string | Display name |
dexNr | number | null | National Pokedex number |
rating | number | PvPoke rating score |
moveset | string[] | Recommended moves (fast + charged) |
matchups | array | Top 5 favorable matchups |
counters | array | Top 5 counters |
Example
curl https://mknepprath.github.io/lily-dex-api/rankings.jsonRaid Bosses
GEThttps://mknepprath.github.io/lily-dex-api/raidboss.jsonCurrent raid bosses organized by tier, including CP ranges, weather boosts, and type information.
Example
curl https://mknepprath.github.io/lily-dex-api/raidboss.jsonMax Battles
GEThttps://mknepprath.github.io/lily-dex-api/maxbattles.jsonCurrent Max Battle (Dynamax) Pokemon available in-game.
Example
curl https://mknepprath.github.io/lily-dex-api/maxbattles.jsonTypes
GEThttps://mknepprath.github.io/lily-dex-api/types.jsonPokemon type effectiveness chart with damage multipliers and weather boost associations.
Example
curl https://mknepprath.github.io/lily-dex-api/types.jsonQuests
GEThttps://mknepprath.github.io/lily-dex-api/quests.jsonSpecial research and field research quest data.
Example
curl https://mknepprath.github.io/lily-dex-api/quests.jsonEvents
GEThttps://mknepprath.github.io/lily-dex-api/events.jsonPokemon GO events parsed from the GO Calendar ICS feed. Timestamps are naive (no timezone) so they can be interpreted in the user's local timezone, matching how Pokemon GO events work.
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique event identifier |
summary | string | Original ICS summary with tag prefix |
tag | string | Event type tag (CD, RB, RH, SH, MM, MB, GBL, E, R, RD, GP, PGF) |
title | string | Clean event title without tag prefix |
description | string | Event description text |
startDate | string | Start date/time as naive string (e.g. 2026-03-14T14:00:00) |
endDate | string | End date/time as naive string |
isAllDay | boolean | Whether this is an all-day event |
url | string | null | Leek Duck event page URL |
imageURL | string | null | Event image URL |
pokemonDexNrs | number[] | Matched Pokemon national dex numbers |
Example
curl https://mknepprath.github.io/lily-dex-api/events.jsonMeta
GEThttps://mknepprath.github.io/lily-dex-api/meta.jsonBuild metadata including timestamp, source statuses, Pokemon count, and API version.
Response Fields
| Field | Type | Description |
|---|---|---|
buildTime | string | ISO 8601 timestamp of last build |
sources | object | Status of each data source (fresh or cached) |
pokemonCount | number | Total released Pokemon count |
version | string | API version |
Example
curl https://mknepprath.github.io/lily-dex-api/meta.jsonData Freshness
All data is rebuilt every 6 hours via GitHub Actions. The /meta.json endpoint includes the last build timestamp and status of each upstream source. If an upstream source is unavailable, the API falls back to the most recent cached version.
Source Priority
- PokeMiners Game Master — stats, moves, evolution requirements, buddy distance
- PvPoke — released Pokemon, PvP rankings, optimal IVs, second charge move costs
- Pokemon GO API — localized names, raid bosses, types, sprites
- GO Calendar — event schedule (Community Days, Raid Hours, Spotlight Hours, GO Fest, etc.)