Information

This is a consumption-only API—only the HTTP GET method is available on resources.

No authentication is required to access this API, and all resources are fully open and available. Since the move to static hosting in autumn 2018, rate limiting has been changed to a fixed limit of 100 API requests per IP address per minute.

If you are going to be regularly using the API, we recommend caching data on your service or deploying your own instance of the API (this can be done for free on Netlify's free tier).

Fair Use Policy

PokéAPI is free and open to use. It is also very popular. Because of this, we ask every developer to abide by our fair use policy. People not complying with the fair use policy will have their IP address permenantly banned.

PokéAPI is primarily an educational tool, and we will not tolerate denial of service attacks preventing people from learning.

Rules:

  • Locally cache resources and images whenever you request them.
  • Use the correct user-agent header in API requests.
  • Be nice and friendly to your fellow PokéAPI developers.

Slack

Have questions? Ideas? Notice something amiss here in the docs? Hit us up on Slack. Sign up right here then visit our Slack team. We encourage you to come here before opening a ticket on GitHub, so we can keep our issues nice and organized. There are also a solid group of people using the API who may already have answers or plans from experience.

Wrapper Libraries

Resource Lists

Calling any API endpoint without a resource ID or name will return a paginated list of available resources for that API. By default, a list 'page' will contain up to 20 resources. If you would like to change this just add a 'limit' query parameter, e.g. limit=60.

Un-named

GET /api/v2/{endpoint}/

{
  "count": 365,
  "next": "https://pokeapi.co/api/v2/evolution-chain/?limit=20&offset=20",
  "previous": null,
  "results": [
    {
      "url": "https://pokeapi.co/api/v2/evolution-chain/1/"
    }
  ]
}

APIResourceList

NameDescriptionType
countThe total number of resources available from this API.integer
nextThe URL for the next page in the list.string
previousThe URL for the previous page in the list.boolean
resultsA list of un-named API resources.list APIResource

Named

GET /api/v2/{endpoint}/

{
  "count": 248,
  "next": "https://pokeapi.co/api/v2/ability/?limit=20&offset=20",
  "previous": null,
  "results": [
    {
      "name": "stench",
      "url": "https://pokeapi.co/api/v2/ability/1/"
    }
  ]
}

NamedAPIResourceList

NameDescriptionType
countThe total number of resources available from this API.integer
nextThe URL for the next page in the list.string
previousThe URL for the previous page in the list.boolean
resultsA list of named API resources.list NamedAPIResource

Berries

Berries

Berries are small fruits that can provide HP and status condition restoration, stat enhancement, and even damage negation when eaten by Pokémon. Check out Bulbapedia for greater detail.

GET /api/v2/berry/{id or name}/

{
  "id": 1,
  "name": "cheri",
  "growth_time": 3,
  "max_harvest": 5,
  "natural_gift_power": 60,
  "size": 20,
  "smoothness": 25,
  "soil_dryness": 15,
  "firmness": {
    "name": "soft",
    "url": "https://pokeapi.co/api/v2/berry-firmness/2/"
  },
  "flavors": [
    {
      "potency": 10,
      "flavor": {
        "name": "spicy",
        "url": "https://pokeapi.co/api/v2/berry-flavor/1/"
      }
    }
  ],
  "item": {
    "name": "cheri-berry",
    "url": "https://pokeapi.co/api/v2/item/126/"
  },
  "natural_gift_type": {
    "name": "fire",
    "url": "https://pokeapi.co/api/v2/type/10/"
  }
}

Berry

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
growth_timeTime it takes the tree to grow one stage, in hours. Berry trees go through four of these growth stages before they can be picked.integer
max_harvestThe maximum number of these berries that can grow on one tree in Generation IV.integer
natural_gift_powerThe power of the move "Natural Gift" when used with this Berry.integer
sizeThe size of this Berry, in millimeters.integer
smoothnessThe smoothness of this Berry, used in making Pokéblocks or Poffins.integer
soil_drynessThe speed at which this Berry dries out the soil as it grows. A higher rate means the soil dries more quickly.integer
firmnessThe firmness of this berry, used in making Pokéblocks or Poffins.NamedAPIResource (BerryFirmness)
flavorsA list of references to each flavor a berry can have and the potency of each of those flavors in regard to this berry.list BerryFlavorMap
itemBerries are actually items. This is a reference to the item specific data for this berry.NamedAPIResource (Item)
natural_gift_typeThe type inherited by "Natural Gift" when used with this Berry.NamedAPIResource (Type)

BerryFlavorMap

NameDescriptionType
potencyHow powerful the referenced flavor is for this berry.integer
flavorThe referenced berry flavor.NamedAPIResource (BerryFlavor)

Berry Firmnesses

GET /api/v2/berry-firmness/{id or name}/

{
  "id": 1,
  "name": "very-soft",
  "berries": [
    {
      "name": "pecha",
      "url": "https://pokeapi.co/api/v2/berry/3/"
    }
  ],
  "names": [
    {
      "name": "Very Soft",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

BerryFirmness

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
berriesA list of the berries with this firmness.list NamedAPIResource (Berry)
namesThe name of this resource listed in different languages.list Name

Berry Flavors

Flavors determine whether a Pokémon will benefit or suffer from eating a berry based on their nature. Check out Bulbapedia for greater detail.

GET /api/v2/berry-flavor/{id or name}/

{
  "id": 1,
  "name": "spicy",
  "berries": [
    {
      "potency": 10,
      "berry": {
        "name": "rowap",
        "url": "https://pokeapi.co/api/v2/berry/64/"
      }
    }
  ],
  "contest_type": {
    "name": "cool",
    "url": "https://pokeapi.co/api/v2/contest-type/1/"
  },
  "names": [
    {
      "name": "Spicy",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

BerryFlavor

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
berriesA list of the berries with this flavor.list FlavorBerryMap
contest_typeThe contest type that correlates with this berry flavor.NamedAPIResource (ContestType)
namesThe name of this resource listed in different languages.list Name

FlavorBerryMap

NameDescriptionType
potencyHow powerful the referenced flavor is for this berry.integer
berryThe berry with the referenced flavor.NamedAPIResource (Berry)

Contests

Contest Types

Contest types are categories judges used to weigh a Pokémon's condition in Pokémon contests. Check out Bulbapedia for greater detail.

GET /api/v2/contest-type/{id or name}/

{
  "id": 1,
  "name": "cool",
  "berry_flavor": {
    "name": "spicy",
    "url": "https://pokeapi.co/api/v2/berry-flavor/1/"
  },
  "names": [
    {
      "name": "Cool",
      "color": "Red",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

ContestType

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
berry_flavorThe berry flavor that correlates with this contest type.NamedAPIResource (BerryFlavor)
namesThe name of this contest type listed in different languages.list ContestName

ContestName

NameDescriptionType
nameThe name for this contest.string
colorThe color associated with this contest's name.string
languageThe language that this name is in.NamedAPIResource (Language)

Contest Effects

Contest effects refer to the effects of moves when used in contests.

GET /api/v2/contest-effect/{id}/

{
  "id": 1,
  "appeal": 4,
  "jam": 0,
  "effect_entries": [
    {
      "effect": "Gives a high number of appeal points wth no other effects.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "flavor_text_entries": [
    {
      "flavor_text": "A highly appealing move.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

ContestEffect

NameDescriptionType
idThe identifier for this resource.integer
appealThe base number of hearts the user of this move gets.integer
jamThe base number of hearts the user's opponent loses.integer
effect_entriesThe result of this contest effect listed in different languages.list Effect
flavor_text_entriesThe flavor text of this contest effect listed in different languages.list FlavorText

Super Contest Effects

Super contest effects refer to the effects of moves when used in super contests.

GET /api/v2/super-contest-effect/{id}/

{
  "id": 1,
  "appeal": 2,
  "flavor_text_entries": [
    {
      "flavor_text": "Enables the user to perform first in the next turn.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "moves": [
    {
      "name": "agility",
      "url": "https://pokeapi.co/api/v2/move/97/"
    }
  ]
}

SuperContestEffect

NameDescriptionType
idThe identifier for this resource.integer
appealThe level of appeal this super contest effect has.integer
flavor_text_entriesThe flavor text of this super contest effect listed in different languages.list FlavorText
movesA list of moves that have the effect when used in super contests.list NamedAPIResource (Move)

Encounters

Encounter Methods

Methods by which the player might can encounter Pokémon in the wild, e.g., walking in tall grass. Check out Bulbapedia for greater detail.

GET /api/v2/encounter-method/{id or name}/

{
  "id": 1,
  "name": "walk",
  "order": 1,
  "names": [
    {
      "name": "Walking in tall grass or a cave",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

EncounterMethod

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
orderA good value for sorting.integer
namesThe name of this resource listed in different languages.list Name

Encounter Conditions

Conditions which affect what pokemon might appear in the wild, e.g., day or night.

GET /api/v2/encounter-condition/{id or name}/

{
  "id": 1,
  "name": "swarm",
  "values": [
    {
      "name": "swarm-yes",
      "url": "https://pokeapi.co/api/v2/encounter-condition-value/1/"
    },
    {
      "name": "swarm-no",
      "url": "https://pokeapi.co/api/v2/encounter-condition-value/2/"
    }
  ],
  "names": [
    {
      "name": "Schwarm",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ]
}

EncounterCondition

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
valuesA list of possible values for this encounter condition.list NamedAPIResource (EncounterConditionValue)

Encounter Condition Values

Encounter condition values are the various states that an encounter condition can have, i.e., time of day can be either day or night.

GET /api/v2/encounter-condition-value/{id or name}/

{
  "id": 1,
  "name": "swarm-yes",
  "condition": {
    "name": "swarm",
    "url": "https://pokeapi.co/api/v2/encounter-condition/1/"
  },
  "names": [
    {
      "name": "Während eines Schwarms",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ]
}

EncounterConditionValue

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
conditionThe condition this encounter condition value pertains to.list NamedAPIResource (EncounterCondition)
namesThe name of this resource listed in different languages.list Name

Evolution

Evolution Chains

Evolution chains are essentially family trees. They start with the lowest stage within a family and detail evolution conditions for each as well as Pokémon they can evolve into up through the hierarchy.

GET /api/v2/evolution-chain/{id}/

{
  "id": 7,
  "baby_trigger_item": null,
  "chain": {
    "is_baby": false,
    "species": {
      "name": "rattata",
      "url": "https://pokeapi.co/api/v2/pokemon-species/19/"
    },
    "evolution_details": null,
    "evolves_to": [
      {
        "is_baby": false,
        "species": {
          "name": "raticate",
          "url": "https://pokeapi.co/api/v2/pokemon-species/20/"
        },
        "evolution_details": {
          "item": null,
          "trigger": {
            "name": "level-up",
            "url": "https://pokeapi.co/api/v2/evolution-trigger/1/"
          },
          "gender": null,
          "held_item": null,
          "known_move": null,
          "known_move_type": null,
          "location": null,
          "min_level": 20,
          "min_happiness": null,
          "min_beauty": null,
          "min_affection": null,
          "needs_overworld_rain": false,
          "party_species": null,
          "party_type": null,
          "relative_physical_stats": null,
          "time_of_day": "",
          "trade_species": null,
          "turn_upside_down": false
        },
        "evolves_to": []
      }
    ]
  }
}

EvolutionChain

NameDescriptionType
idThe identifier for this resource.integer
baby_trigger_itemThe item that a Pokémon would be holding when mating that would trigger the egg hatching a baby Pokémon rather than a basic Pokémon.NamedAPIResource (Item)
chainThe base chain link object. Each link contains evolution details for a Pokémon in the chain. Each link references the next Pokémon in the natural evolution order.ChainLink
NameDescriptionType
is_babyWhether or not this link is for a baby Pokémon. This would only ever be true on the base link.boolean
speciesThe Pokémon species at this point in the evolution chain.NamedAPIResource (PokemonSpecies)
evolution_detailsAll details regarding the specific details of the referenced Pokémon species evolution.list EvolutionDetail
evolves_toA List of chain objects.list ChainLink

EvolutionDetail

NameDescriptionType
itemThe item required to cause evolution this into Pokémon species.NamedAPIResource (Item)
triggerThe type of event that triggers evolution into this Pokémon species.NamedAPIResource (EvolutionTrigger)
genderThe id of the gender of the evolving Pokémon species must be in order to evolve into this Pokémon species.integer
held_itemThe item the evolving Pokémon species must be holding during the evolution trigger event to evolve into this Pokémon species.NamedAPIResource (Item)
known_moveThe move that must be known by the evolving Pokémon species during the evolution trigger event in order to evolve into this Pokémon species.NamedAPIResource (Move)
known_move_typeThe evolving Pokémon species must know a move with this type during the evolution trigger event in order to evolve into this Pokémon species.NamedAPIResource (Type)
locationThe location the evolution must be triggered at.NamedAPIResource (Location)
min_levelThe minimum required level of the evolving Pokémon species to evolve into this Pokémon species.integer
min_happinessThe minimum required level of happiness the evolving Pokémon species to evolve into this Pokémon species.integer
min_beautyThe minimum required level of beauty the evolving Pokémon species to evolve into this Pokémon species.integer
min_affectionThe minimum required level of affection the evolving Pokémon species to evolve into this Pokémon species.integer
needs_overworld_rainWhether or not it must be raining in the overworld to cause evolution this Pokémon species.boolean
party_speciesThe Pokémon species that must be in the players party in order for the evolving Pokémon species to evolve into this Pokémon species.NamedAPIResource (PokemonSpecies)
party_typeThe player must have a Pokémon of this type in their party during the evolution trigger event in order for the evolving Pokémon species to evolve into this Pokémon species.NamedAPIResource (Type)
relative_physical_statsThe required relation between the Pokémon's Attack and Defense stats. 1 means Attack > Defense. 0 means Attack = Defense. -1 means Attack < Defense.integer
time_of_dayThe required time of day. Day or night.string
trade_speciesPokémon species for which this one must be traded.NamedAPIResource (PokemonSpecies)
turn_upside_downWhether or not the 3DS needs to be turned upside-down as this Pokémon levels up.boolean

Evolution Triggers

Evolution triggers are the events and conditions that cause a Pokémon to evolve. Check out Bulbapedia for greater detail.

GET /api/v2/evolution-trigger/{id or name}/

{
  "id": 1,
  "name": "level-up",
  "names": [
    {
      "name": "Level up",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "ivysaur",
      "url": "https://pokeapi.co/api/v2/pokemon-species/2/"
    }
  ]
}

EvolutionTrigger

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
pokemon_speciesA list of pokemon species that result from this evolution trigger.list NamedAPIResource (PokemonSpecies)

Games

Generations

A generation is a grouping of the Pokémon games that separates them based on the Pokémon they include. In each generation, a new set of Pokémon, Moves, Abilities and Types that did not exist in the previous generation are released.

GET /api/v2/generation/{id or name}/

{
  "id": 1,
  "name": "generation-i",
  "abilities": [],
  "main_region": {
    "name": "kanto",
    "url": "https://pokeapi.co/api/v2/region/1/"
  },
  "moves": [
    {
      "name": "pound",
      "url": "https://pokeapi.co/api/v2/move/1/"
    }
  ],
  "names": [
    {
      "name": "Generation I",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "bulbasaur",
      "url": "https://pokeapi.co/api/v2/pokemon-species/1/"
    }
  ],
  "types": [
    {
      "name": "normal",
      "url": "https://pokeapi.co/api/v2/type/1/"
    }
  ],
  "version_groups": [
    {
      "name": "red-blue",
      "url": "https://pokeapi.co/api/v2/version-group/1/"
    }
  ]
}

Generation

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
abilitiesA list of abilities that were introduced in this generation.list NamedAPIResource (Ability)
namesThe name of this resource listed in different languages.list Name
main_regionThe main region travelled in this generation.NamedAPIResource (Region)
movesA list of moves that were introduced in this generation.list NamedAPIResource (Move)
pokemon_speciesA list of Pokémon species that were introduced in this generation.list NamedAPIResource (PokemonSpecies)
typesA list of types that were introduced in this generation.list NamedAPIResource (Type)
version_groupsA list of version groups that were introduced in this generation.list NamedAPIResource (VersionGroup)

Pokedexes

A Pokédex is a handheld electronic encyclopedia device; one which is capable of recording and retaining information of the various Pokémon in a given region with the exception of the national dex and some smaller dexes related to portions of a region. See Bulbapedia for greater detail.

GET /api/v2/pokedex/{id or name}/

{
  "id": 2,
  "name": "kanto",
  "is_main_series": true,
  "descriptions": [
    {
      "description": "Rot/Blau/Gelb Kanto Dex",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "names": [
    {
      "name": "Kanto",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "pokemon_entries": [
    {
      "entry_number": 1,
      "pokemon_species": {
        "name": "bulbasaur",
        "url": "https://pokeapi.co/api/v2/pokemon-species/1/"
      }
    }
  ],
  "region": {
    "name": "kanto",
    "url": "https://pokeapi.co/api/v2/region/1/"
  },
  "version_groups": [
    {
      "name": "red-blue",
      "url": "https://pokeapi.co/api/v2/version-group/1/"
    }
  ]
}

Pokedex

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
is_main_seriesWhether or not this Pokédex originated in the main series of the video games.boolean
descriptionsThe description of this resource listed in different languages.list Description
namesThe name of this resource listed in different languages.list Name
pokemon_entriesA list of Pokémon catalogued in this Pokédex and their indexes.list PokemonEntry
regionThe region this Pokédex catalogues Pokémon for.NamedAPIResource (Region)
version_groupsA list of version groups this Pokédex is relevant to.list NamedAPIResource (VersionGroup)

PokemonEntry

NameDescriptionType
entry_numberThe index of this Pokémon species entry within the Pokédex.integer
pokemon_speciesThe Pokémon species being encountered.NamedAPIResource (PokemonSpecies)

Version

Versions of the games, e.g., Red, Blue or Yellow.

GET /api/v2/version/{id or name}/

{
  "id": 1,
  "name": "red",
  "names": [
    {
      "name": "Rot",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "version_group": {
    "name": "red-blue",
    "url": "https://pokeapi.co/api/v2/version-group/1/"
  }
}

Version

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
version_groupThe version group this version belongs to.NamedAPIResource (VersionGroup)

Version Groups

Version groups categorize highly similar versions of the games.

GET /api/v2/version-group/{id or name}/

{
  "id": 1,
  "name": "red-blue",
  "order": 1,
  "generation": {
    "name": "generation-i",
    "url": "https://pokeapi.co/api/v2/generation/1/"
  },
  "move_learn_methods": [
    {
      "name": "level-up",
      "url": "https://pokeapi.co/api/v2/move-learn-method/1/"
    }
  ],
  "pokedexes": [
    {
      "name": "kanto",
      "url": "https://pokeapi.co/api/v2/pokedex/2/"
    }
  ],
  "regions": [
    {
      "name": "kanto",
      "url": "https://pokeapi.co/api/v2/region/1/"
    }
  ],
  "versions": [
    {
      "name": "red",
      "url": "https://pokeapi.co/api/v2/version/1/"
    }
  ]
}

VersionGroup

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
orderOrder for sorting. Almost by date of release, except similar versions are grouped together.integer
generationThe generation this version was introduced in.NamedAPIResource (Generation)
move_learn_methodsA list of methods in which Pokémon can learn moves in this version group.list NamedAPIResource (MoveLearnMethod)
pokedexesA list of Pokédexes introduces in this version group.list NamedAPIResource (Pokedex)
regionsA list of regions that can be visited in this version group.list NamedAPIResource (Region)
versionsThe versions this version group owns.list NamedAPIResource (Version)

Items

Item

An item is an object in the games which the player can pick up, keep in their bag, and use in some manner. They have various uses, including healing, powering up, helping catch Pokémon, or to access a new area.

GET /api/v2/item{id or name}/

{
  "id": 1,
  "name": "master-ball",
  "cost": 0,
  "fling_power": 10,
  "fling_effect": {
    "name": "flinch",
    "url": "https://pokeapi.co/api/v2/item-fling-effect/7/"
  },
  "attributes": [
    {
      "name": "holdable",
      "url": "https://pokeapi.co/api/v2/item-attribute/5/"
    }
  ],
  "category": {
    "name": "standard-balls",
    "url": "https://pokeapi.co/api/v2/item-category/34/"
  },
  "effect_entries": [
    {
      "effect": "Used in battle\n:   [Catches]{mechanic:catch} a wild Pokémon without fail.\n\n    If used in a trainer battle, nothing happens and the ball is lost.",
      "short_effect": "Catches a wild Pokémon every time.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "flavor_text_entries": [
    {
      "text": "The best Poké Ball with the ultimate level of performance. With it, you will catch any wild Pokémon without fail.",
      "version_group": {
        "name": "x-y",
        "url": "https://pokeapi.co/api/v2/version-group/15/"
      },
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "game_indices": [
    {
      "game_index": 1,
      "generation": {
        "name": "generation-vi",
        "url": "https://pokeapi.co/api/v2/generation/6/"
      }
    }
  ],
  "names": [
    {
      "name": "Master Ball",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "sprites": {
    "default": "http://pokeapi.co/media/sprites/items/master-ball.png"
  },
  "held_by_pokemon": [
    {
      "pokemon": {
        "name": "chansey",
        "url": "https://pokeapi.co/api/v2/pokemon/113/"
      },
      "version_details": [
        {
          "rarity": 50,
          "version": {
            "name": "soulsilver",
            "url": "https://pokeapi.co/api/v2/version/16/"
          }
        }
      ]
    }
  ],
  "baby_trigger_for": {
    "url": "https://pokeapi.co/api/v2/evolution-chain/1/"
  }
}

Item

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
costThe price of this item in stores.integer
fling_powerThe power of the move Fling when used with this item.integer
fling_effectThe effect of the move Fling when used with this item.NamedAPIResource (ItemFlingEffect)
attributesA list of attributes this item has.list NamedAPIResource (ItemAttribute)
categoryThe category of items this item falls into.ItemCategory
effect_entriesThe effect of this ability listed in different languages.list VerboseEffect
flavor_text_entriesThe flavor text of this ability listed in different languages.list VersionGroupFlavorText
game_indicesA list of game indices relevent to this item by generation.list GenerationGameIndex
namesThe name of this item listed in different languages.list Name
spritesA set of sprites used to depict this item in the game.ItemSprites
held_by_pokemonA list of Pokémon that might be found in the wild holding this item.list ItemHolderPokemon
baby_trigger_forAn evolution chain this item requires to produce a bay during mating.APIResource (EvolutionChain)
machinesA list of the machines related to this item.list MachineVersionDetail

ItemSprites

NameDescriptionType
defaultThe default depiction of this item.string

ItemHolderPokemon

NameDescriptionType
pokemonThe Pokémon that holds this item.string
version_detailsThe details for the version that this item is held in by the Pokémon.list ItemHolderPokemonVersionDetail

ItemHolderPokemonVersionDetail

NameDescriptionType
rarityHow often this Pokémon holds this item in this version.string
versionThe version that this item is held in by the Pokémon.NamedAPIResource (Version)

Item Attributes

Item attributes define particular aspects of items, e.g. "usable in battle" or "consumable".

GET /api/v2/item-attribute/{id or name}/

{
  "id": 1,
  "name": "countable",
  "descriptions": [
    {
      "description": "Has a count in the bag",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "items": [
    {
      "name": "master-ball",
      "url": "https://pokeapi.co/api/v2/item/1/"
    }
  ],
  "names": [
    {
      "name": "Countable",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

ItemAttribute

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
itemsA list of items that have this attribute.list NamedAPIResource (Item)
namesThe name of this item attribute listed in different languages.list Name
descriptionsThe description of this item attribute listed in different languages.list Description

Item Categories

Item categories determine where items will be placed in the players bag.

GET /api/v2/item-category/{id or name}/

{
  "id": 1,
  "name": "stat-boosts",
  "items": [
    {
      "name": "guard-spec",
      "url": "https://pokeapi.co/api/v2/item/55/"
    }
  ],
  "names": [
    {
      "name": "Stat boosts",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "pocket": {
    "name": "battle",
    "url": "https://pokeapi.co/api/v2/item-pocket/7/"
  }
}

ItemCategory

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
itemsA list of items that are a part of this category.list NamedAPIResource (Item)
namesThe name of this item category listed in different languages.list Name
pocketThe pocket items in this category would be put in.NamedAPIResource (ItemPocket)

Item Fling Effects

The various effects of the move "Fling" when used with different items.

GET /api/v2/item-fling-effect/{id or name}/

{
  "id": 1,
  "name": "badly-poison",
  "effect_entries": [
    {
      "effect": "Badly poisons the target.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "items": [
    {
      "name": "toxic-orb",
      "url": "https://pokeapi.co/api/v2/item/249/"
    }
  ]
}

ItemFlingEffect

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
effect_entriesThe result of this fling effect listed in different languages.list Effect
itemsA list of items that have this fling effect.NamedAPIResource (Item)

Item Pockets

Pockets within the players bag used for storing items by category.

GET /api/v2/item-pocket/{id or name}/

{
  "id": 1,
  "name": "misc",
  "categories": [
    {
      "name": "collectibles",
      "url": "https://pokeapi.co/api/v2/item-category/9/"
    }
  ],
  "names": [
    {
      "name": "Items",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

ItemPocket

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
categoriesA list of item categories that are relevant to this item pocket.list NamedAPIResource (ItemCategory)
namesThe name of this resource listed in different languages.list Name

Locations

Locations

Locations that can be visited within the games. Locations make up sizable portions of regions, like cities or routes.

GET /api/v2/location/{id}/

{
  "id": 1,
  "name": "canalave-city",
  "region": {
    "name": "sinnoh",
    "url": "https://pokeapi.co/api/v2/region/4/"
  },
  "names": [
    {
      "name": "Canalave City",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "game_indices": [
    {
      "game_index": 7,
      "generation": {
        "name": "generation-iv",
        "url": "https://pokeapi.co/api/v2/generation/4/"
      }
    }
  ],
  "areas": [
    {
      "name": "canalave-city-area",
      "url": "https://pokeapi.co/api/v2/location-area/1/"
    }
  ]
}

Location

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
regionThe region this location can be found in.NamedAPIResource (Region)
namesThe name of this resource listed in different languages.list Name
game_indicesA list of game indices relevent to this location by generation.list GenerationGameIndex
areasAreas that can be found within this location.list NamedAPIResource (LocationArea)

Location Areas

Location areas are sections of areas, such as floors in a building or cave. Each area has its own set of possible Pokémon encounters.

GET /api/v2/location-area/{id}/

{
  "id": 1,
  "name": "canalave-city-area",
  "game_index": 1,
  "encounter_method_rates": [
    {
      "encounter_method": {
        "name": "old-rod",
        "url": "https://pokeapi.co/api/v2/encounter-method/2/"
      },
      "version_details": [
        {
          "rate": 25,
          "version": {
            "name": "platinum",
            "url": "https://pokeapi.co/api/v2/version/14/"
          }
        }
      ]
    }
  ],
  "location": {
    "name": "canalave-city",
    "url": "https://pokeapi.co/api/v2/location/1/"
  },
  "names": [
    {
      "name": "",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "pokemon_encounters": [
    {
      "pokemon": {
        "name": "tentacool",
        "url": "https://pokeapi.co/api/v2/pokemon/72/"
      },
      "version_details": [
        {
          "version": {
            "name": "diamond",
            "url": "https://pokeapi.co/api/v2/version/12/"
          },
          "max_chance": 60,
          "encounter_details": [
            {
              "min_level": 20,
              "max_level": 30,
              "condition_values": [],
              "chance": 60,
              "method": {
                "name": "surf",
                "url": "https://pokeapi.co/api/v2/encounter-method/5/"
              }
            }
          ]
        }
      ]
    }
  ]
}

LocationArea

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
game_indexThe internal id of an API resource within game data.integer
encounter_method_ratesA list of methods in which Pokémon may be encountered in this area and how likely the method will occur depending on the version of the game.list EncounterMethodRate
locationThe region this location can be found in.NamedAPIResource (Region)
namesThe name of this resource listed in different languages.list Name
pokemon_encountersA list of Pokémon that can be encountered in this area along with version specific details about the encounter.list PokemonEncounter

EncounterMethodRate

NameDescriptionType
encounter_methodThe method in which Pokémon may be encountered in an area..NamedAPIResource (EncounterMethod)
version_detailsThe chance of the encounter to occur on a version of the game.list EncounterVersionDetails

EncounterVersionDetails

NameDescriptionType
rateThe chance of an encounter to occur.integer
versionThe version of the game in which the encounter can occur with the given chance.NamedAPIResource (Version)

PokemonEncounter

NameDescriptionType
pokemonThe Pokémon being encountered.NamedAPIResource (Pokemon)
version_detailsA list of versions and encounters with Pokémon that might happen in the referenced location area.list VersionEncounterDetail

Pal Park Areas

Areas used for grouping Pokémon encounters in Pal Park. They're like habitats that are specific to Pal Park.

GET /api/v2/pal-park-area/{id or name}/

{
  "id": 1,
  "name": "forest",
  "names": [
    {
      "name": "Forest",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "pokemon_encounters": [
    {
      "base_score": 30,
      "rate": 50,
      "pokemon_species": {
        "name": "caterpie",
        "url": "https://pokeapi.co/api/v2/pokemon-species/10/"
      }
    }
  ]
}

PalParkArea

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
pokemon_encountersA list of Pokémon encountered in thi pal park area along with details.list PalParkEncounterSpecies

PalParkEncounterSpecies

NameDescriptionType
base_scoreThe base score given to the player when this Pokémon is caught during a pal park run.integer
rateThe base rate for encountering this Pokémon in this pal park area.integer
pokemon_speciesThe Pokémon species being encountered.NamedAPIResource (PokemonSpecies)

Regions

A region is an organized area of the Pokémon world. Most often, the main difference between regions is the species of Pokémon that can be encountered within them.

GET /api/v2/region/{id or name}/

{
  "id": 1,
  "name": "kanto",
  "locations": [
    {
      "name": "celadon-city",
      "url": "https://pokeapi.co/api/v2/location/67/"
    }
  ],
  "main_generation": {
    "name": "generation-i",
    "url": "https://pokeapi.co/api/v2/generation/1/"
  },
  "names": [
    {
      "name": "Kanto",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "pokedexes": [
    {
      "name": "kanto",
      "url": "https://pokeapi.co/api/v2/pokedex/2/"
    }
  ],
  "version_groups": [
    {
      "name": "red-blue",
      "url": "https://pokeapi.co/api/v2/version-group/1/"
    }
  ]
}

Region

NameDescriptionType
idThe identifier for this resource.integer
locationsA list of locations that can be found in this region.list NamedAPIResource (Location)
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
main_generationThe generation this region was introduced in.NamedAPIResource (Generation)
pokedexesA list of pokédexes that catalogue Pokémon in this region.list NamedAPIResource (Pokedex)
version_groupsA list of version groups where this region can be visited.list NamedAPIResource (VersionGroup)

Machines

Machines

Machines are the representation of items that teach moves to Pokémon. They vary from version to version, so it is not certain that one specific TM or HM corresponds to a single Machine.

GET /api/v2/machine/{id}/

{
  "id": 1,
  "item": {
    "name": "tm01",
    "url": "https://pokeapi.co/api/v2/item/305/"
  },
  "move": {
    "name": "mega-punch",
    "url": "https://pokeapi.co/api/v2/move/5/"
  },
  "version_group": {
    "name": "red-blue",
    "url": "https://pokeapi.co/api/v2/version/1/"
  }
}

Machine

NameDescriptionType
idThe identifier for this resource.integer
itemThe TM or HM item that corresponds to this machine.NamedAPIResource (Item)
moveThe move that is taught by this machine.NamedAPIResource (Move)
version_groupThe version group that this machine applies to.NamedAPIResource (VersionGroup)

Moves

Moves

Moves are the skills of Pokémon in battle. In battle, a Pokémon uses one move each turn. Some moves (including those learned by Hidden Machine) can be used outside of battle as well, usually for the purpose of removing obstacles or exploring new areas.

GET /api/v2/move/{id or name}/

{
  "id": 1,
  "name": "pound",
  "accuracy": 100,
  "effect_chance": null,
  "pp": 35,
  "priority": 0,
  "power": 40,
  "contest_combos": {
    "normal": {
      "use_before": [
        {
          "name": "double-slap",
          "url": "https://pokeapi.co/api/v2/move/3/"
        },
        {
          "name": "headbutt",
          "url": "https://pokeapi.co/api/v2/move/29/"
        },
        {
          "name": "feint-attack",
          "url": "https://pokeapi.co/api/v2/move/185/"
        }
      ],
      "use_after": null
    },
    "super": {
      "use_before": null,
      "use_after": null
    }
  },
  "contest_type": {
    "name": "tough",
    "url": "https://pokeapi.co/api/v2/contest-type/5/"
  },
  "contest_effect": {
    "url": "https://pokeapi.co/api/v2/contest-effect/1/"
  },
  "damage_class": {
    "name": "physical",
    "url": "https://pokeapi.co/api/v2/move-damage-class/2/"
  },
  "effect_entries": [
    {
      "effect": "Inflicts [regular damage]{mechanic:regular-damage}.",
      "short_effect": "Inflicts regular damage with no additional effect.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "effect_changes": [],
  "generation": {
    "name": "generation-i",
    "url": "https://pokeapi.co/api/v2/generation/1/"
  },
  "meta": {
    "ailment": {
      "name": "none",
      "url": "https://pokeapi.co/api/v2/move-ailment/0/"
    },
    "category": {
      "name": "damage",
      "url": "https://pokeapi.co/api/v2/move-category/0/"
    },
    "min_hits": null,
    "max_hits": null,
    "min_turns": null,
    "max_turns": null,
    "drain": 0,
    "healing": 0,
    "crit_rate": 0,
    "ailment_chance": 0,
    "flinch_chance": 0,
    "stat_chance": 0
  },
  "names": [
    {
      "name": "Pound",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "past_values": [],
  "stat_changes": [],
  "super_contest_effect": {
    "url": "https://pokeapi.co/api/v2/super-contest-effect/5/"
  },
  "target": {
    "name": "selected-pokemon",
    "url": "https://pokeapi.co/api/v2/move-target/10/"
  },
  "type": {
    "name": "normal",
    "url": "https://pokeapi.co/api/v2/type/1/"
  },
  "flavor_text_entries": [
    {
      "flavor_text": "Pounds with fore­\nlegs or tail.",
      "language": {
        "url": "https://pokeapi.co/api/v2/language/9/",
        "name": "en"
      },
      "version_group": {
        "url": "https://pokeapi.co/api/v2/version-group/3/",
        "name": "gold-silver"
      }
    }
  ]
}

Move

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
accuracyThe percent value of how likely this move is to be successful.integer
effect_chanceThe percent value of how likely it is this moves effect will happen.integer
ppPower points. The number of times this move can be used.integer
priorityA value between -8 and 8. Sets the order in which moves are executed during battle. See [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Priority) for greater detail.integer
powerThe base power of this move with a value of 0 if it does not have a base power.integer
contest_combosA detail of normal and super contest combos that require this move.ContestComboSets
contest_typeThe type of appeal this move gives a Pokémon when used in a contest.NamedAPIResource (ContestType)
contest_effectThe effect the move has when used in a contest.APIResource (ContestEffect)
damage_classThe type of damage the move inflicts on the target, e.g. physical.NamedAPIResource (MoveDamageClass)
effect_entriesThe effect of this move listed in different languages.list VerboseEffect
effect_changesThe list of previous effects this move has had across version groups of the games.list AbilityEffectChange
flavor_text_entriesThe flavor text of this move listed in different languages.list MoveFlavorText
generationThe generation in which this move was introduced.NamedAPIResource (Generation)
machinesA list of the machines that teach this move.list MachineVersionDetail
metaMetadata about this moveMoveMetaData
namesThe name of this resource listed in different languages.list Name
past_valuesA list of move resource value changes across version groups of the game.list PastMoveStatValues
stat_changesA list of stats this moves effects and how much it effects them.list MoveStatChange
super_contest_effectThe effect the move has when used in a super contest.APIResource (SuperContestEffect)
targetThe type of target that will receive the effects of the attack.NamedAPIResource (MoveTarget)
typeThe elemental type of this move.NamedAPIResource (Type)

ContestComboSets

NameDescriptionType
normalA detail of moves this move can be used before or after, granting additional appeal points in contests.ContestComboDetail
superA detail of moves this move can be used before or after, granting additional appeal points in super contests.ContestComboDetail

ContestComboDetail

NameDescriptionType
use_beforeA list of moves to use before this move.list NamedAPIResource
use_afterA list of moves to use after this move.list NamedAPIResource

MoveFlavorText

NameDescriptionType
flavor_textThe localized flavor text for an api resource in a specific language.string
languageThe language this name is in.NamedAPIResource (Language)
version_groupThe version group that uses this flavor text.NamedAPIResource (VersionGroup)

MoveAilment

NameDescriptionType
ailmentThe status ailment this move inflicts on its target.NamedAPIResource (MoveAilment)
categoryThe category of move this move falls under, e.g. damage or ailment.NamedAPIResource (Move)
min_hitsThe minimum number of times this move hits. Null if it always only hits once.integer
max_hitsThe maximum number of times this move hits. Null if it always only hits once.integer
min_turnsThe minimum number of turns this move continues to take effect. Null if it always only lasts one turn.integer
max_turnsThe maximum number of turns this move continues to take effect. Null if it always only lasts one turn.integer
drainHP drain (if positive) or Recoil damage (if negative), in percent of damage done.integer
healingThe amount of hp gained by the attacking Pokemon, in percent of it's maximum HP.integer
crit_rateCritical hit rate bonus.integer
ailment_chanceThe likelihood this attack will cause an ailment.integer
flinch_chanceThe likelihood this attack will cause the target Pokémon to flinch.integer
stat_chanceThe likelihood this attack will cause a stat change in the target Pokémon.integer

MoveStatChange

NameDescriptionType
changeThe amount of change.integer
statThe stat being affected.NamedAPIResource (Stat)

PastMoveStatValues

NameDescriptionType
accuracyThe percent value of how likely this move is to be successful.PastMoveStatValues
effect_chanceThe percent value of how likely it is this moves effect will take effect.integer
powerThe base power of this move with a value of 0 if it does not have a base power.integer
ppPower points. The number of times this move can be used.integer
effect_entriesThe effect of this move listed in different languages.list VerboseEffect
typeThe elemental type of this move.NamedAPIResource (Type)
version_groupThe version group in which these move stat values were in effect.NamedAPIResource (VersionGroup)

Move Ailments

Move Ailments are status conditions caused by moves used during battle. See Bulbapedia for greater detail.

GET /api/v2/move-ailment/{id or name}/

{
  "id": 1,
  "name": "paralysis",
  "moves": [
    {
      "name": "thunder-punch",
      "url": "https://pokeapi.co/api/v2/move/9/"
    }
  ],
  "names": [
    {
      "name": "Paralysis",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

MoveAilment

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
movesA list of moves that cause this ailment.list NamedAPIResource (Move)
namesThe name of this resource listed in different languages.list Name

Move Battle Styles

Styles of moves when used in the Battle Palace. See Bulbapedia for greater detail.

GET /api/v2/move-battle-style/{id or name}/

{
  "id": 1,
  "name": "attack",
  "names": [
    {
      "name": "Attack",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

MoveBattleStyle

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name

Move Categories

Very general categories that loosely group move effects.

GET /api/v2/move-category/{id or name}/

{
  "id": 1,
  "name": "ailment",
  "descriptions": [
    {
      "description": "No damage; inflicts status ailment",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "moves": [
    {
      "name": "sing",
      "url": "https://pokeapi.co/api/v2/move/47/"
    }
  ]
}

ModelName

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
movesA list of moves that fall into this category.list NamedAPIResource (Move)
descriptionsThe description of this resource listed in different languages.list Description

Move Damage Classes

Damage classes moves can have, e.g. physical, special, or non-damaging.

GET /api/v2/move-damage-class/{id or name}/

{
  "id": 1,
  "name": "status",
  "descriptions": [
    {
      "description": "ダメージない",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ],
  "moves": [
    {
      "name": "swords-dance",
      "url": "https://pokeapi.co/api/v2/move/14/"
    }
  ]
}

ModelName

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
descriptionsThe description of this resource listed in different languages.list Description
movesA list of moves that fall into this damage class.list NamedAPIResource (Move)
namesThe name of this resource listed in different languages.list Name

Move Learn Methods

Methods by which Pokémon can learn moves.

GET /api/v2/move-learn-method/{id or name}/

{
  "id": 1,
  "name": "level-up",
  "names": [
    {
      "name": "Level up",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "descriptions": [
    {
      "description": "Wird gelernt, wenn ein Pokémon ein bestimmtes Level erreicht.",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "version_groups": [
    {
      "name": "red-blue",
      "url": "https://pokeapi.co/api/v2/version-group/1/"
    }
  ]
}

MoveLearnMethod

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
descriptionsThe description of this resource listed in different languages.list Description
namesThe name of this resource listed in different languages.list Name
version_groupsA list of version groups where moves can be learned through this method.list NamedAPIResource (VersionGroup)

Move Targets

Targets moves can be directed at during battle. Targets can be Pokémon, environments or even other moves.

GET /api/v2/move-target/{id or name}/

{
  "id": 1,
  "name": "specific-move",
  "descriptions": [
    {
      "description": "Eine spezifische Fähigkeit. Wie diese Fähigkeit genutzt wird, hängt von den genutzten Fähigkeiten ab.",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "moves": [
    {
      "name": "counter",
      "url": "https://pokeapi.co/api/v2/move/68/"
    }
  ],
  "names": [
    {
      "name": "Spezifische Fähigkeit",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ]
}

MoveTarget

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
descriptionsThe description of this resource listed in different languages.list Description
movesA list of moves that that are directed at this target.list NamedAPIResource (Move)
namesThe name of this resource listed in different languages.list Name

Pokemon

Abilities

Abilities provide passive effects for Pokémon in battle or in the overworld. Pokémon have multiple possible abilities but can have only one ability at a time. Check out Bulbapedia for greater detail.

GET /api/v2/ability/{id or name}/

{
  "id": 1,
  "name": "stench",
  "is_main_series": true,
  "generation": {
    "name": "generation-iii",
    "url": "https://pokeapi.co/api/v2/generation/3/"
  },
  "names": [
    {
      "name": "Stench",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "effect_entries": [
    {
      "effect": "This Pokémon's damaging moves have a 10% chance to make the target [flinch]{mechanic:flinch} with each hit if they do not already cause flinching as a secondary effect.\n\nThis ability does not stack with a held item.\n\nOverworld: The wild encounter rate is halved while this Pokémon is first in the party.",
      "short_effect": "Has a 10% chance of making target Pokémon [flinch]{mechanic:flinch} with each hit.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "effect_changes": [
    {
      "version_group": {
        "name": "black-white",
        "url": "https://pokeapi.co/api/v2/version-group/11/"
      },
      "effect_entries": [
        {
          "effect": "Has no effect in battle.",
          "language": {
            "name": "en",
            "url": "https://pokeapi.co/api/v2/language/9/"
          }
        }
      ]
    }
  ],
  "flavor_text_entries": [
    {
      "flavor_text": "臭くて 相手が\nひるむ ことがある。",
      "language": {
        "name": "ja-kanji",
        "url": "https://pokeapi.co/api/v2/language/11/"
      },
      "version_group": {
        "name": "x-y",
        "url": "https://pokeapi.co/api/v2/version-group/15/"
      }
    }
  ],
  "pokemon": [
    {
      "is_hidden": true,
      "slot": 3,
      "pokemon": {
        "name": "gloom",
        "url": "https://pokeapi.co/api/v2/pokemon/44/"
      }
    }
  ]
}

Ability

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
is_main_seriesWhether or not this ability originated in the main series of the video games.boolean
generationThe generation this ability originated in.NamedAPIResource (Generation)
namesThe name of this resource listed in different languages.list Name
effect_entriesThe effect of this ability listed in different languages.list names
effect_changesThe list of previous effects this ability has had across version groups.list AbilityEffectChange
flavor_text_entriesThe flavor text of this ability listed in different languages.list AbilityFlavorText
pokemonA list of Pokémon that could potentially have this ability.list AbilityPokemon

AbilityEffectChange

NameDescriptionType
effect_entriesThe previous effect of this ability listed in different languages.list Effect
version_groupThe version group in which the previous effect of this ability originated.NamedAPIResource (VersionGroup)

AbilityFlavorText

NameDescriptionType
flavor_textThe localized name for an API resource in a specific language.string
languageThe language this text resource is in.NamedAPIResource (Language)
version_groupThe version group that uses this flavor text.NamedAPIResource (VersionGroup)

AbilityPokemon

NameDescriptionType
is_hiddenWhether or not this a hidden ability for the referenced Pokémon.boolean
slotPokémon have 3 ability 'slots' which hold references to possible abilities they could have. This is the slot of this ability for the referenced pokemon.integer
pokemonThe Pokémon this ability could belong to.NamedAPIResource (Pokemon)

Characteristics

Characteristics indicate which stat contains a Pokémon's highest IV. A Pokémon's Characteristic is determined by the remainder of its highest IV divided by 5 (gene_modulo). Check out Bulbapedia for greater detail.

GET /api/v2/characteristic/{id}/

{
  "id": 1,
  "gene_modulo": 0,
  "possible_values": [
    0,
    5,
    10,
    15,
    20,
    25,
    30
  ],
  "highest_stat": {
    "name": "hp",
    "url": "https://pokeapi.co/api/v2/stat/1/"
  },
  "descriptions": [
    {
      "description": "Loves to eat",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

Characteristic

NameDescriptionType
idThe identifier for this resource.integer
gene_moduloThe remainder of the highest stat/IV divided by 5.integer
possible_valuesThe possible values of the highest stat that would result in a Pokémon recieving this characteristic when divided by 5.list integer

Egg Groups

Egg Groups are categories which determine which Pokémon are able to interbreed. Pokémon may belong to either one or two Egg Groups. Check out Bulbapedia for greater detail.

GET /api/v2/egg-group/{id or name}/

{
  "id": 1,
  "name": "monster",
  "names": [
    {
      "name": "かいじゅう",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "bulbasaur",
      "url": "https://pokeapi.co/api/v2/pokemon-species/1/"
    }
  ]
}

EggGroup

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
pokemon_speciesA list of all Pokémon species that are members of this egg group.list NamedAPIResource (PokemonSpecies)

Genders

Genders were introduced in Generation II for the purposes of breeding Pokémon but can also result in visual differences or even different evolutionary lines. Check out Bulbapedia for greater detail.

GET /api/v2/gender/{id or name}/

{
  "id": 1,
  "name": "female",
  "pokemon_species_details": [
    {
      "rate": 1,
      "pokemon_species": {
        "name": "bulbasaur",
        "url": "https://pokeapi.co/api/v2/pokemon-species/1/"
      }
    }
  ],
  "required_for_evolution": [
    {
      "name": "wormadam",
      "url": "https://pokeapi.co/api/v2/pokemon-species/413/"
    }
  ]
}

Gender

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
pokemon_species_detailsA list of Pokémon species that can be this gender and how likely it is that they will be.list PokemonSpeciesGender
required_for_evolutionA list of Pokémon species that required this gender in order for a Pokémon to evolve into them.list NamedAPIResource (PokemonSpecies)

PokemonSpeciesGender

NameDescriptionType
rateThe chance of this Pokémon being female, in eighths; or -1 for genderless.integer
pokemon_speciesA Pokémon species that can be the referenced gender.NamedAPIResource (PokemonSpecies)

Growth Rates

Growth rates are the speed with which Pokémon gain levels through experience. Check out Bulbapedia for greater detail.

GET /api/v2/growth-rate/{id or name}/

{
  "id": 1,
  "name": "slow",
  "formula": "\\frac{5x^3}{4}",
  "descriptions": [
    {
      "description": "langsam",
      "language": {
        "name": "de",
        "url": "https://pokeapi.co/api/v2/language/6/"
      }
    }
  ],
  "levels": [
    {
      "level": 100,
      "experience": 1250000
    }
  ],
  "pokemon_species": [
    {
      "name": "growlithe",
      "url": "https://pokeapi.co/api/v2/pokemon-species/58/"
    }
  ]
}

GrowthRate

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
formulaThe formula used to calculate the rate at which the Pokémon species gains level.string
descriptionsThe descriptions of this characteristic listed in different languages.list Description
levelsA list of levels and the amount of experienced needed to atain them based on this growth rate.list GrowthRateExperienceLevel
pokemon_speciesA list of Pokémon species that gain levels at this growth rate.list NamedAPIResource (PokemonSpecies)

GrowthRateExperienceLevel

NameDescriptionType
levelThe level gained.integer
experienceThe amount of experience required to reach the referenced level.integer

Natures

Natures influence how a Pokémon's stats grow. See Bulbapedia for greater detail.

GET /api/v2/nature/{id or name}/

{
  "id": 2,
  "name": "bold",
  "decreased_stat": {
    "name": "attack",
    "url": "https://pokeapi.co/api/v2/stat/2/"
  },
  "increased_stat": {
    "name": "defense",
    "url": "https://pokeapi.co/api/v2/stat/3/"
  },
  "likes_flavor": {
    "name": "sour",
    "url": "https://pokeapi.co/api/v2/berry-flavor/5/"
  },
  "hates_flavor": {
    "name": "spicy",
    "url": "https://pokeapi.co/api/v2/berry-flavor/1/"
  },
  "pokeathlon_stat_changes": [
    {
      "max_change": -2,
      "pokeathlon_stat": {
        "name": "speed",
        "url": "https://pokeapi.co/api/v2/pokeathlon-stat/1/"
      }
    }
  ],
  "move_battle_style_preferences": [
    {
      "low_hp_preference": 32,
      "high_hp_preference": 30,
      "move_battle_style": {
        "name": "attack",
        "url": "https://pokeapi.co/api/v2/move-battle-style/1/"
      }
    }
  ],
  "names": [
    {
      "name": "がんばりや",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ]
}

Nature

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
decreased_statThe stat decreased by 10% in Pokémon with this nature.NamedAPIResource (Stat)
increased_statThe stat increased by 10% in Pokémon with this nature.NamedAPIResource (Stat)
hates_flavorThe flavor hated by Pokémon with this nature.NamedAPIResource (BerryFlavor)
likes_flavorThe flavor liked by Pokémon with this nature.NamedAPIResource (BerryFlavor)
pokeathlon_stat_changesA list of Pokéathlon stats this nature effects and how much it effects them.list NatureStatChange
move_battle_style_preferencesA list of battle styles and how likely a Pokémon with this nature is to use them in the Battle Palace or Battle Tent.list MoveBattleStylePreference
namesThe name of this resource listed in different languages.list Name

NatureStatChange

NameDescriptionType
max_changeThe amount of change.integer
pokeathlon_statThe stat being affected.NamedAPIResource (PokeathlonStat)

MoveBattleStylePreference

NameDescriptionType
low_hp_preferenceChance of using the move, in percent, if HP is under one half.integer
high_hp_preferenceChance of using the move, in percent, if HP is over one half.integer
move_battle_styleThe move battle style.NamedAPIResource (MoveBattleStyle)

Pokeathlon Stats

Pokeathlon Stats are different attributes of a Pokémon's performance in Pokéathlons. In Pokéathlons, competitions happen on different courses; one for each of the different Pokéathlon stats. See Bulbapedia for greater detail.

GET /api/v2/pokeathlon-stat/{id or name}/

{
  "id": 1,
  "name": "speed",
  "affecting_natures": {
    "increase": [
      {
        "max_change": 2,
        "nature": {
          "name": "timid",
          "url": "https://pokeapi.co/api/v2/nature/5/"
        }
      }
    ],
    "decrease": [
      {
        "max_change": -1,
        "nature": {
          "name": "hardy",
          "url": "https://pokeapi.co/api/v2/nature/1/"
        }
      }
    ]
  },
  "names": [
    {
      "name": "Speed",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

PokeathlonStat

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
affecting_naturesA detail of natures which affect this Pokéathlon stat positively or negatively.NaturePokeathlonStatAffectSets

NaturePokeathlonStatAffectSets

NameDescriptionType
increaseA list of natures and how they change the referenced Pokéathlon stat.list NaturePokeathlonStatAffect
decreaseA list of natures and how they change the referenced Pokéathlon stat.list NaturePokeathlonStatAffect

NaturePokeathlonStatAffect

NameDescriptionType
max_changeThe maximum amount of change to the referenced Pokéathlon stat.integer
natureThe nature causing the change.NamedAPIResource (Nature)

Pokemon

Pokémon are the creatures that inhabit the world of the Pokémon games. They can be caught using Pokéballs and trained by battling with other Pokémon. See Bulbapedia for greater detail.

GET /api/v2/pokemon/{id or name}/

{
  "id": 12,
  "name": "butterfree",
  "base_experience": 178,
  "height": 11,
  "is_default": true,
  "order": 16,
  "weight": 320,
  "abilities": [
    {
      "is_hidden": true,
      "slot": 3,
      "ability": {
        "name": "tinted-lens",
        "url": "https://pokeapi.co/api/v2/ability/110/"
      }
    }
  ],
  "forms": [
    {
      "name": "butterfree",
      "url": "https://pokeapi.co/api/v2/pokemon-form/12/"
    }
  ],
  "game_indices": [
    {
      "game_index": 12,
      "version": {
        "name": "white-2",
        "url": "https://pokeapi.co/api/v2/version/22/"
      }
    }
  ],
  "held_items": [
    {
      "item": {
        "name": "silver-powder",
        "url": "https://pokeapi.co/api/v2/item/199/"
      },
      "version_details": [
        {
          "rarity": 5,
          "version": {
            "name": "y",
            "url": "https://pokeapi.co/api/v2/version/24/"
          }
        }
      ]
    }
  ],
  "location_area_encounters": [
    {
      "location_area": {
        "name": "kanto-route-2-south-towards-viridian-city",
        "url": "https://pokeapi.co/api/v2/location-area/296/"
      },
      "version_details": [
        {
          "max_chance": 10,
          "encounter_details": [
            {
              "min_level": 7,
              "max_level": 7,
              "condition_values": [
                {
                  "name": "time-morning",
                  "url": "https://pokeapi.co/api/v2/encounter-condition-value/3/"
                }
              ],
              "chance": 5,
              "method": {
                "name": "walk",
                "url": "https://pokeapi.co/api/v2/encounter-method/1/"
              }
            }
          ],
          "version": {
            "name": "heartgold",
            "url": "https://pokeapi.co/api/v2/version/15/"
          }
        }
      ]
    }
  ],
  "moves": [
    {
      "move": {
        "name": "flash",
        "url": "https://pokeapi.co/api/v2/move/148/"
      },
      "version_group_details": [
        {
          "level_learned_at": 0,
          "version_group": {
            "name": "x-y",
            "url": "https://pokeapi.co/api/v2/version-group/15/"
          },
          "move_learn_method": {
            "name": "machine",
            "url": "https://pokeapi.co/api/v2/move-learn-method/4/"
          }
        }
      ]
    }
  ],
  "species": {
    "name": "butterfree",
    "url": "https://pokeapi.co/api/v2/pokemon-species/12/"
  },
  "sprites": {
    "back_female": "http://pokeapi.co/media/sprites/pokemon/back/female/12.png",
    "back_shiny_female": "http://pokeapi.co/media/sprites/pokemon/back/shiny/female/12.png",
    "back_default": "http://pokeapi.co/media/sprites/pokemon/back/12.png",
    "front_female": "http://pokeapi.co/media/sprites/pokemon/female/12.png",
    "front_shiny_female": "http://pokeapi.co/media/sprites/pokemon/shiny/female/12.png",
    "back_shiny": "http://pokeapi.co/media/sprites/pokemon/back/shiny/12.png",
    "front_default": "http://pokeapi.co/media/sprites/pokemon/12.png",
    "front_shiny": "http://pokeapi.co/media/sprites/pokemon/shiny/12.png"
  },
  "stats": [
    {
      "base_stat": 70,
      "effort": 0,
      "stat": {
        "name": "speed",
        "url": "https://pokeapi.co/api/v2/stat/6/"
      }
    }
  ],
  "types": [
    {
      "slot": 2,
      "type": {
        "name": "flying",
        "url": "https://pokeapi.co/api/v2/type/3/"
      }
    }
  ]
}

Pokemon

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
base_experienceThe base experience gained for defeating this Pokémon.integer
heightThe height of this Pokémon in decimetres.integer
is_defaultSet for exactly one Pokémon used as the default for each species.boolean
orderOrder for sorting. Almost national order, except families are grouped together.integer
weightThe weight of this Pokémon in hectograms.integer
abilitiesA list of abilities this Pokémon could potentially have.list PokemonAbility
formsA list of forms this Pokémon can take on.list NamedAPIResource (PokemonForm)
game_indicesA list of game indices relevent to Pokémon item by generation.list VersionGameIndex
held_itemsA list of items this Pokémon may be holding when encountered.list PokemonHeldItem
location_area_encountersA link to a list of location areas, as well as encounter details pertaining to specific versions.string
movesA list of moves along with learn methods and level details pertaining to specific version groups.list PokemonMove
spritesA set of sprites used to depict this Pokémon in the game.PokemonSprites
speciesThe species this Pokémon belongs to.NamedAPIResource (PokemonSpecies)
statsA list of base stat values for this Pokémon.list PokemonStat
typesA list of details showing types this Pokémon has.list PokemonType

PokemonAbility

NameDescriptionType
is_hiddenWhether or not this is a hidden ability.boolean
slotThe slot this ability occupies in this Pokémon species.integer
abilityThe ability the Pokémon may have.NamedAPIResource (Ability)

PokemonType

NameDescriptionType
slotThe order the Pokémon's types are listed in.integer
typeThe type the referenced Pokémon has.NamedAPIResource (Type)

PokemonHeldItem

NameDescriptionType
itemThe item the referenced Pokémon holds.NamedAPIResource (Item)
version_detailsThe details of the different versions in which the item is held.list PokemonHeldItemVersion

PokemonHeldItemVersion

NameDescriptionType
versionThe version in which the item is held.NamedAPIResource (Version)
rarityHow often the item is held.integer

PokemonMove

NameDescriptionType
moveThe move the Pokémon can learn.NamedAPIResource (Move)
version_group_detailsThe details of the version in which the Pokémon can learn the move.list PokemonMoveVersion

PokemonMoveVersion

NameDescriptionType
move_learn_methodThe method by which the move is learned.NamedAPIResource (MoveLearnMethod)
version_groupThe version group in which the move is learned.NamedAPIResource (VersionGroup)
level_learned_atThe minimum level to learn the move.integer

PokemonStat

NameDescriptionType
statThe stat the Pokémon has.NamedAPIResource (Stat)
effortThe effort points (EV) the Pokémon has in the stat.integer
base_statThe base value of the stst.integer

PokemonSprites

NameDescriptionType
front_defaultThe default depiction of this Pokémon from the front in battle.string
front_shinyThe shiny depiction of this Pokémon from the front in battle.string
front_femaleThe female depiction of this Pokémon from the front in battle.string
front_shiny_femaleThe shiny female depiction of this Pokémon from the front in battle.string
back_defaultThe default depiction of this Pokémon from the back in battle.string
back_shinyThe shiny depiction of this Pokémon from the back in battle.string
back_femaleThe female depiction of this Pokémon from the back in battle.string
back_shiny_femaleThe shiny female depiction of this Pokémon from the back in battle.string

LocationAreaEncounter

NameDescriptionType
location_areaThe location area the referenced Pokémon can be encountered in.NamedAPIResource (LocationArea)
version_detailsA list of versions and encounters with the referenced Pokémon that might happen.list VersionEncounterDetail

Pokémon Colors

Colors used for sorting Pokémon in a Pokédex. The color listed in the Pokédex is usually the color most apparent or covering each Pokémon's body. No orange category exists; Pokémon that are primarily orange are listed as red or brown.

GET /api/v2/pokemon-color/{id or name}/

{
  "id": 1,
  "name": "black",
  "names": [
    {
      "name": "黒い",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "snorlax",
      "url": "https://pokeapi.co/api/v2/pokemon-species/143/"
    }
  ]
}

PokemonColor

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
pokemon_speciesA list of the Pokémon species that have this color.list NamedAPIResource (PokemonSpecies)

Pokémon Forms

Some Pokémon have the ability to take on different forms. At times, these differences are purely cosmetic and have no bearing on the difference in the Pokémon's stats from another; however, several Pokémon differ in stats (other than HP), type, and Ability depending on their form.

GET /api/v2/pokemon-form/{id or name}/

{
  "id": 413,
  "name": "wormadam-plant",
  "order": 503,
  "form_order": 1,
  "is_default": true,
  "is_battle_only": false,
  "is_mega": false,
  "form_name": "plant",
  "pokemon": {
    "name": "wormadam-plant",
    "url": "https://pokeapi.co/api/v2/pokemon/413/"
  },
  "sprites": {
    "back_default": "http://pokeapi.co/media/sprites/pokemon/back/413.png",
    "back_shiny": "http://pokeapi.co/media/sprites/pokemon/back/shiny/413.png",
    "front_default": "http://pokeapi.co/media/sprites/pokemon/413.png",
    "front_shiny": "http://pokeapi.co/media/sprites/pokemon/shiny/413.png"
  },
  "version_group": {
    "name": "diamond-pearl",
    "url": "https://pokeapi.co/api/v2/version-group/8/"
  }
}

PokemonForm

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
orderThe order in which forms should be sorted within all forms. Multiple forms may have equal order, in which case they should fall back on sorting by name.integer
form_orderThe order in which forms should be sorted within a species' forms.integer
is_defaultTrue for exactly one form used as the default for each Pokémon.boolean
is_battle_onlyWhether or not this form can only happen during battle.boolean
is_megaWhether or not this form requires mega evolution.boolean
form_nameThe name of this form.string
pokemonThe Pokémon that can take on this form.NamedAPIResource (Pokemon)
spritesA set of sprites used to depict this Pokémon form in the game.PokemonFormSprites
version_groupThe version group this Pokémon form was introduced in.NamedAPIResource (VersionGroup)
namesThe form specific full name of this Pokémon form, or empty if the form does not have a specific name.list Name
form_namesThe form specific form name of this Pokémon form, or empty if the form does not have a specific name.list Name

PokemonFormSprites

NameDescriptionType
front_defaultThe default depiction of this Pokémon form from the front in battle.string
front_shinyThe shiny depiction of this Pokémon form from the front in battle.string
back_defaultThe default depiction of this Pokémon form from the back in battle.string
back_shinyThe shiny depiction of this Pokémon form from the back in battle.string

Pokémon Habitats

Habitats are generally different terrain Pokémon can be found in but can also be areas designated for rare or legendary Pokémon.

GET /api/v2/pokemon-habitat/{id or name}/

{
  "id": 1,
  "name": "cave",
  "names": [
    {
      "name": "grottes",
      "language": {
        "name": "fr",
        "url": "https://pokeapi.co/api/v2/language/5/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "zubat",
      "url": "https://pokeapi.co/api/v2/pokemon-species/41/"
    }
  ]
}

PokemonHabitat

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
namesThe name of this resource listed in different languages.list Name
pokemon_speciesA list of the Pokémon species that can be found in this habitat.list NamedAPIResource (PokemonSpecies)

Pokémon Shapes

Shapes used for sorting Pokémon in a Pokédex.

GET /api/v2/pokemon-shape/{id or name}/

{
  "id": 1,
  "name": "ball",
  "awesome_names": [
    {
      "awesome_name": "Pomaceous",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "names": [
    {
      "name": "Ball",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "pokemon_species": [
    {
      "name": "shellder",
      "url": "https://pokeapi.co/api/v2/pokemon-species/90/"
    }
  ]
}

PokemonShape

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
awesome_namesThe "scientific" name of this Pokémon shape listed in different languages.list AwesomeName
namesThe name of this resource listed in different languages.list Name
pokemon_speciesA list of the Pokémon species that have this shape.list PokemonSpecies

AwesomeName

NameDescriptionType
awesome_nameThe localized "scientific" name for an API resource in a specific language.string
languageThe language this "scientific" name is in.NamedAPIResource (Language)

Pokémon Species

A Pokémon Species forms the basis for at least one Pokémon. Attributes of a Pokémon species are shared across all varieties of Pokémon within the species. A good example is Wormadam; Wormadam is the species which can be found in three different varieties, Wormadam-Trash, Wormadam-Sandy and Wormadam-Plant.

GET /api/v2/pokemon-species/{id or name}/

{
  "id": 413,
  "name": "wormadam",
  "order": 441,
  "gender_rate": 8,
  "capture_rate": 45,
  "base_happiness": 70,
  "is_baby": false,
  "hatch_counter": 15,
  "has_gender_differences": false,
  "forms_switchable": false,
  "growth_rate": {
    "name": "medium",
    "url": "https://pokeapi.co/api/v2/growth-rate/2/"
  },
  "pokedex_numbers": [
    {
      "entry_number": 45,
      "pokedex": {
        "name": "kalos-central",
        "url": "https://pokeapi.co/api/v2/pokedex/12/"
      }
    }
  ],
  "egg_groups": [
    {
      "name": "bug",
      "url": "https://pokeapi.co/api/v2/egg-group/3/"
    }
  ],
  "color": {
    "name": "gray",
    "url": "https://pokeapi.co/api/v2/pokemon-color/4/"
  },
  "shape": {
    "name": "squiggle",
    "url": "https://pokeapi.co/api/v2/pokemon-shape/2/"
  },
  "evolves_from_species": {
    "name": "burmy",
    "url": "https://pokeapi.co/api/v2/pokemon-species/412/"
  },
  "evolution_chain": {
    "url": "https://pokeapi.co/api/v2/evolution-chain/213/"
  },
  "habitat": null,
  "generation": {
    "name": "generation-iv",
    "url": "https://pokeapi.co/api/v2/generation/4/"
  },
  "names": [
    {
      "name": "Wormadam",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "flavor_text_entries": [
    {
      "flavor_text": "When the bulb on\nits back grows\nlarge, it appears\fto lose the\nability to stand\non its hind legs.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      },
      "version": {
        "name": "red",
        "url": "https://pokeapi.co/api/v2/version/1/"
      }
    }
  ],
  "form_descriptions": [
    {
      "description": "Forms have different stats and movepools.  During evolution, Burmy's current cloak becomes Wormadam's form, and can no longer be changed.",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "genera": [
    {
      "genus": "Bagworm",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ],
  "varieties": [
    {
      "is_default": true,
      "pokemon": {
        "name": "wormadam-plant",
        "url": "https://pokeapi.co/api/v2/pokemon/413/"
      }
    }
  ]
}

PokemonSpecies

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
orderThe order in which species should be sorted. Based on National Dex order, except families are grouped together and sorted by stage.integer
gender_rateThe chance of this Pokémon being female, in eighths; or -1 for genderless.integer
capture_rateThe base capture rate; up to 255. The higher the number, the easier the catch.integer
base_happinessThe happiness when caught by a normal Pokéball; up to 255. The higher the number, the happier the Pokémon.integer
is_babyWhether or not this is a baby Pokémon.boolean
hatch_counterInitial hatch counter: one must walk 255 × (hatch_counter + 1) steps before this Pokémon's egg hatches, unless utilizing bonuses like Flame Body's.integer
has_gender_differencesWhether or not this Pokémon has visual gender differences.boolean
forms_switchableWhether or not this Pokémon has multiple forms and can switch between them.boolean
growth_rateThe rate at which this Pokémon species gains levels.NamedAPIResource (GrowthRate)
pokedex_numbersA list of Pokedexes and the indexes reserved within them for this Pokémon species.list PokemonSpeciesDexEntry
egg_groupsA list of egg groups this Pokémon species is a member of.list NamedAPIResource (EggGroup)
colorThe color of this Pokémon for Pokédex search.NamedAPIResource (PokemonColor)
shapeThe shape of this Pokémon for Pokédex search.NamedAPIResource (PokemonShape)
evolves_from_speciesThe Pokémon species that evolves into this Pokemon_species.NamedAPIResource (PokemonSpecies)
evolution_chainThe evolution chain this Pokémon species is a member of.APIResource (EvolutionChain)
habitatThe habitat this Pokémon species can be encountered in.NamedAPIResource (PokemonHabitat)
generationThe generation this Pokémon species was introduced in.NamedAPIResource (Generation)
namesThe name of this resource listed in different languages.list Name
pal_park_encountersA list of encounters that can be had with this Pokémon species in pal park.list PalParkEncounterArea
flavor_text_entriesA list of flavor text entries for this Pokémon species.list FlavorText
form_descriptionsDescriptions of different forms Pokémon take on within the Pokémon species.list Description
generaThe genus of this Pokémon species listed in multiple languages.list Genus
varietiesA list of the Pokémon that exist within this Pokémon species.list PokemonSpeciesVariety

Genus

NameDescriptionType
genusThe localized genus for the referenced Pokémon speciesstring
languageThe language this genus is in.NamedAPIResource (Language)

PokemonSpeciesDexEntry

NameDescriptionType
entry_numberThe index number within the Pokédex.integer
pokedexThe Pokédex the referenced Pokémon species can be found in.NamedAPIResource (Pokedex)

PalParkEncounterArea

NameDescriptionType
base_scoreThe base score given to the player when the referenced Pokémon is caught during a pal park run.integer
rateThe base rate for encountering the referenced Pokémon in this pal park area.integer
areaThe pal park area where this encounter happens.NamedAPIResource (PalParkArea)

PokemonSpeciesVariety

NameDescriptionType
is_defaultWhether this variety is the default variety.boolean
pokemonThe Pokémon variety.NamedAPIResource (Pokemon)

Stats

Stats determine certain aspects of battles. Each Pokémon has a value for each stat which grows as they gain levels and can be altered momentarily by effects in battles.

GET /api/v2/stat/{id or name}/

{
  "id": 2,
  "name": "attack",
  "game_index": 2,
  "is_battle_only": false,
  "affecting_moves": {
    "increase": [
      {
        "change": 2,
        "move": {
          "name": "swords-dance",
          "url": "https://pokeapi.co/api/v2/move/14/"
        }
      }
    ],
    "decrease": [
      {
        "change": -1,
        "move": {
          "name": "growl",
          "url": "https://pokeapi.co/api/v2/move/45/"
        }
      }
    ]
  },
  "affecting_natures": {
    "increase": [
      {
        "name": "lonely",
        "url": "https://pokeapi.co/api/v2/nature/6/"
      }
    ],
    "decrease": [
      {
        "name": "bold",
        "url": "https://pokeapi.co/api/v2/nature/2/"
      }
    ]
  },
  "characteristics": [
    {
      "url": "https://pokeapi.co/api/v2/characteristic/2/"
    }
  ],
  "move_damage_class": {
    "name": "physical",
    "url": "https://pokeapi.co/api/v2/move-damage-class/2/"
  },
  "names": [
    {
      "name": "こうげき",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ]
}

Stat

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
game_indexID the games use for this stat.integer
is_battle_onlyWhether this stat only exists within a battle.boolean
affecting_movesA detail of moves which affect this stat positively or negatively.MoveStatAffectSets
affecting_naturesA detail of natures which affect this stat positively or negatively.NatureStatAffectSets
characteristicsA list of characteristics that are set on a Pokémon when its highest base stat is this stat.APIResource (Characteristic)
move_damage_classThe class of damage this stat is directly related to.NamedAPIResource (MoveDamageClass)
namesThe name of this resource listed in different languages.list Name

MoveStatAffectSets

NameDescriptionType
increaseA list of moves and how they change the referenced stat.list MoveStatAffect
decreaseA list of moves and how they change the referenced stat.list MoveStatAffect

MoveStatAffect

NameDescriptionType
changeThe maximum amount of change to the referenced stat.integer
moveThe move causing the change.NamedAPIResource (Move)

NatureStatAffectSets

NameDescriptionType
increaseA list of natures and how they change the referenced stat.list NamedAPIResource (Nature)
decreaseA list of nature sand how they change the referenced stat.list NamedAPIResource (Nature)

Types

Types are properties for Pokémon and their moves. Each type has three properties: which types of Pokémon it is super effective against, which types of Pokémon it is not very effective against, and which types of Pokémon it is completely ineffective against.

GET /api/v2/type/{id or name}/

{
  "id": 5,
  "name": "ground",
  "damage_relations": {
    "no_damage_to": [
      {
        "name": "flying",
        "url": "https://pokeapi.co/api/v2/type/3/"
      }
    ],
    "half_damage_to": [
      {
        "name": "bug",
        "url": "https://pokeapi.co/api/v2/type/7/"
      }
    ],
    "double_damage_to": [
      {
        "name": "poison",
        "url": "https://pokeapi.co/api/v2/type/4/"
      }
    ],
    "no_damage_from": [
      {
        "name": "electric",
        "url": "https://pokeapi.co/api/v2/type/13/"
      }
    ],
    "half_damage_from": [
      {
        "name": "poison",
        "url": "https://pokeapi.co/api/v2/type/4/"
      }
    ],
    "double_damage_from": [
      {
        "name": "water",
        "url": "https://pokeapi.co/api/v2/type/11/"
      }
    ]
  },
  "game_indices": [
    {
      "game_index": 4,
      "generation": {
        "name": "generation-i",
        "url": "https://pokeapi.co/api/v2/generation/1/"
      }
    }
  ],
  "generation": {
    "name": "generation-i",
    "url": "https://pokeapi.co/api/v2/generation/1/"
  },
  "move_damage_class": {
    "name": "physical",
    "url": "https://pokeapi.co/api/v2/move-damage-class/2/"
  },
  "names": [
    {
      "name": "じめん",
      "language": {
        "name": "ja",
        "url": "https://pokeapi.co/api/v2/language/1/"
      }
    }
  ],
  "pokemon": [
    {
      "slot": 1,
      "pokemon": {
        "name": "sandshrew",
        "url": "https://pokeapi.co/api/v2/pokemon/27/"
      }
    }
  ],
  "moves": [
    {
      "name": "sand-attack",
      "url": "https://pokeapi.co/api/v2/move/28/"
    }
  ]
}

Type

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
damage_relationsA detail of how effective this type is toward others and vice versa.TypeRelations
game_indicesA list of game indices relevent to this item by generation.list GenerationGameIndex
generationThe generation this type was introduced in.NamedAPIResource (Generation)
move_damage_classThe class of damage inflicted by this type.NamedAPIResource (MoveDamageClass)
namesThe name of this resource listed in different languages.list Name
pokemonA list of details of Pokémon that have this type.list TypePokemon
movesA list of moves that have this type.list NamedAPIResource (Move)

TypePokemon

NameDescriptionType
slotThe order the Pokémon's types are listed in.integer
pokemonThe Pokémon that has the referenced type.NamedAPIResource (Pokemon)

TypeRelations

NameDescriptionType
no_damage_toA list of types this type has no effect on.list NamedAPIResource (Type)
half_damage_toA list of types this type is not very effect against.list NamedAPIResource (Type)
double_damage_toA list of types this type is very effect against.list NamedAPIResource (Type)
no_damage_fromA list of types that have no effect on this type.list NamedAPIResource (Type)
half_damage_fromA list of types that are not very effective against this type.list NamedAPIResource (Type)
double_damage_fromA list of types that are very effective against this type.list NamedAPIResource (Type)

Utility

Languages

Languages for translations of API resource information.

GET /api/v2/language/{id or name}/

{
  "id": 1,
  "name": "ja",
  "official": true,
  "iso639": "ja",
  "iso3166": "jp",
  "names": [
    {
      "name": "Japanese",
      "language": {
        "name": "en",
        "url": "https://pokeapi.co/api/v2/language/9/"
      }
    }
  ]
}

Language

NameDescriptionType
idThe identifier for this resource.integer
nameThe name for this resource.string
officialWhether or not the games are published in this language.boolean
iso639The two-letter code of the country where this language is spoken. Note that it is not unique.string
iso3166The two-letter code of the language. Note that it is not unique.string
namesThe name of this resource listed in different languages.list Name

Common Models

APIResource

NameDescriptionType
urlThe URL of the referenced resource.string

Description

NameDescriptionType
descriptionThe localized description for an API resource in a specific language.string
languageThe language this name is in.NamedAPIResource (Language)

Effect

NameDescriptionType
effectThe localized effect text for an API resource in a specific language.string
languageThe language this effect is in.NamedAPIResource (Language)

Encounter

NameDescriptionType
min_levelThe lowest level the Pokémon could be encountered at.integer
max_levelThe highest level the Pokémon could be encountered at.integer
condition_valuesA list of condition values that must be in effect for this encounter to occur.list NamedAPIResource (EncounterConditionValue)
chancePercent chance that this encounter will occur.integer
methodThe method by which this encounter happens.NamedAPIResource (EncounterMethod)

FlavorText

NameDescriptionType
flavor_textThe localized flavor text for an API resource in a specific language.string
languageThe language this name is in.NamedAPIResource (Language)

GenerationGameIndex

NameDescriptionType
game_indexThe internal id of an API resource within game data.integer
generationThe generation relevent to this game index.NamedAPIResource (Generation)

MachineVersionDetail

NameDescriptionType
machineThe machine that teaches a move from an item.APIResource (Machine)
version_groupThe version group of this specific machine.NamedAPIResource (VersionGroup)

Name

NameDescriptionType
nameThe localized name for an API resource in a specific language.string
languageThe language this name is in.NamedAPIResource (Language)

NamedAPIResource

NameDescriptionType
nameThe name of the referenced resource.string
urlThe URL of the referenced resource.string

VerboseEffect

NameDescriptionType
effectThe localized effect text for an API resource in a specific language.string
short_effectThe localized effect text in brief.string
languageThe language this effect is in.NamedAPIResource (Language)

VersionEncounterDetail

NameDescriptionType
versionThe game version this encounter happens in.NamedAPIResource (Version)
max_chanceThe total percentage of all encounter potential.integer
encounter_detailsA list of encounters and their specifics.list Encounter

VersionGameIndex

NameDescriptionType
game_indexThe internal id of an API resource within game data.integer
versionThe version relevent to this game index.NamedAPIResource (Version)

VersionGroupFlavorText

NameDescriptionType
textThe localized name for an API resource in a specific language.string
languageThe language this name is in.NamedAPIResource (Language)
version_groupThe version group which uses this flavor text.NamedAPIResource (VersionGroup)