Pokémon

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.

Pokemon

Each Pokémon belongs to a specific species but may take on a variant which makes it differ from other Pokémon of the same species, such as base stats, available abilities and typings. See Bulbapedia for greater detail.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
height	number	Yes	The height of this Pokémon in decimetres.
weight	number	Yes	The weight of this Pokémon in hectograms.
is_default	boolean	Yes	Set for exactly one Pokémon used as the default for each species.
base_experience	number	Yes	The base experience gained for defeating this Pokémon.
order	number	Yes	Order for sorting. Almost national order, except families are grouped together.
abilities	Array<PokemonAbility>	Yes	A list of abilities this Pokémon could potentially have.
forms	Array<NamedAPIResource>`	Yes	A list of forms this Pokémon can take on.
game_indices	Array<VersionGameIndex>	Yes	A list of game indices relevent to Pokémon item by generation.
held_items	Array<PokemonHeldItem>	Yes	A list of items this Pokémon may be holding when encountered.
location_area_encounters	string	Yes	A link to a list of location areas, as well as encounter details pertaining to specific versions.
moves	Array<PokemonMove>	Yes	A list of moves along with learn methods and level details pertaining to specific version groups.
past_types	Array<PokemonTypePast>	Yes	A list of details showing types this pokémon had in previous generations.
sprites	PokemonSprites	Yes	A set of sprites used to depict this Pokémon in the game. A visual representation of the various sprites can be found at PokeAPI/sprites.
species	NamedAPIResource	Yes	The species this Pokémon belongs to.
stats	Array<PokemonStat>	Yes	A list of base stat values for this Pokémon.
types	Array<PokemonType>	Yes	A list of details showing types this Pokémon has.

PokemonAbility

Property	Type	Required	Description
is_hidden	boolean	Yes	Whether or not this is a hidden ability.
slot	number	Yes	The slot this ability occupies in this Pokémon species.
ability	NamedAPIResource	Yes	The ability the Pokémon may have.

PokemonHeldItem

Property	Type	Required	Description
item	NamedAPIResource	Yes	The item the referenced Pokémon holds.
version_details	Array<PokemonHeldItemVersion>	Yes	The details of the different versions in which the item is held.

PokemonHeldItemVersion

Property	Type	Required	Description
rarity	number	Yes	How often the item is held.
version	NamedAPIResource	Yes	The version in which the item is held.

PokemonMove

Property	Type	Required	Description
move	NamedAPIResource	Yes	The move the Pokémon can learn.
version_group_details	Array<PokemonMoveVersion>	Yes	The details of the version in which the Pokémon can learn the move.

PokemonMoveVersion

Property	Type	Required	Description
level_learned_at	number	Yes	The minimum level to learn the move.
move_learn_method	NamedAPIResource	Yes	The method by which the move is learned.
version_group	NamedAPIResource	Yes	The version group in which the move is learned.

PokemonSprites

Property	Type	Required	Description
front_default	string	Yes	The default depiction of this Pokémon from the front in battle.
front_shiny	string or null	Yes	The shiny depiction of this Pokémon from the front in battle.
front_female	string or null	Yes	The female depiction of this Pokémon from the front in battle.
front_shiny_female	string or null	Yes	The shiny female depiction of this Pokémon from the front in battle.
back_default	string or null	Yes	The default depiction of this Pokémon from the back in battle.
back_shiny	string or null	Yes	The shiny depiction of this Pokémon from the back in battle.
back_female	string or null	Yes	The female depiction of this Pokémon from the back in battle.
back_shiny_female	string or null	Yes	The shiny female depiction of this Pokémon from the back in battle.
other	object	No	An object grouping other sprite group objects from different mainstream game's sources.
other[key]	object	No	A group of sprites from a different game source.
other[key].front_default	string or null	No	The default depiction of this Pokémon from the front in battle.
other[key].front_shiny	string or null	No	The shiny depiction of this Pokémon from the front in battle.
other[key].front_female	string or null	No	The female depiction of this Pokémon from the front in battle.
other[key].front_shiny_female	string or null	No	The shiny female depiction of this Pokémon from the front in battle.
other[key].back_default	string or null	No	The default depiction of this Pokémon from the back in battle.
other[key].back_shiny	string or null	No	The shiny depiction of this Pokémon from the back in battle.
other[key].back_female	string or null	No	The female depiction of this Pokémon from the back in battle.
other[key].back_shiny_female	string or null	No	The shiny female depiction of this Pokémon from the back in battle.

info

The following strings are other object available keys:

• dream_world
• home
• official-artwork
• showdown

PokemonStat

Property	Type	Required	Description
stat	NamedAPIResource	Yes	The stat the Pokémon has.
effort	number	Yes	The effort points (EV) the Pokémon has in the stat.
base_stat	number	Yes	The base value of the stat.

PokemonType

Property	Type	Required	Description
slot	number	Yes	The order the Pokémon's types are listed in.
type	NamedAPIResource	Yes	The type the referenced Pokémon has.

PokemonTypePast

Property	Type	Required	Description
generation	NamedAPIResource	Yes	The last generation in which the referenced pokémon had the listed types.
types	Array<PokemonType>	Yes	The types the referenced pokémon had up to and including the listed generation.

Ability

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
is_main_series	boolean	Yes	Whether or not this ability originated in the main series of the video games.
generation	NamedAPIResource	Yes	The generation this ability originated in.
effect_entries	Array<VerboseEffect>	Yes	The effect of this ability listed in different languages.
effect_changes	Array<AbilityEffectChange>	Yes	The list of previous effects this ability has had across version groups.
flavor_text_entries	Array<AbilityFlavorText>	Yes	The flavor text of this ability listed in different languages.
pokemon	AbilityPokemon	Yes	A list of Pokémon that could potentially have this ability.

AbilityEffectChange

Property	Type	Required	Description
effect_entries	Array<Effect>	Yes	The previous effect of this ability listed in different languages.
version_group	NamedAPIResource	Yes	The version group in which the previous effect of this ability originated.

AbilityFlavorText

Property	Type	Required	Description
flavor_text	string	Yes	The previous effect of this ability listed in different languages.
language	NamedAPIResource	Yes	The language this text resource is in.
version_group	NamedAPIResource	Yes	The version group that uses this flavor text.

AbilityPokemon

Property	Type	Required	Description
is_hidden	boolean	Yes	Whether or not this a hidden ability for the referenced Pokémon.
slot	number	Yes	Pokémon have 3 ability 'slots' which hold references to possible abilities they could have. This is the slot of this ability for the referenced Pokémon.
pokemon	NamedAPIResource	Yes	The Pokémon this ability could belong to.

Characteristic

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
gene_modulo	number	Yes	The remainder of the highest stat/IV divided by 5.
possible_values	number	Yes	The possible values of the highest stat that would result in a Pokémon recieving this characteristic when divided by 5.
highest_stat	NamedAPIResource	Yes	The stat which results in this characteristic.
descriptions	Array<Description>	Yes	The descriptions of this characteristic listed in different languages.

EggGroup

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	number	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
pokemon_species	Array<NamedAPIResource>	Yes	A list of all Pokémon species that are members of this egg group.

Gender

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	number	Yes	The name for this resource.
pokemon_species_details	Array<PokemonSpecieGender>	Yes	A list of Pokémon species that can be this gender and how likely it is that they will be.
required_for_evolution	Array<NamedAPIResource>	Yes	A list of Pokémon species that required this gender in order for a Pokémon to evolve into them.

PokemonSpecieGender

Property	Type	Required	Description
rate	number	Yes	The chance of this Pokémon being female, in eighths; or -1 for genderless.
pokemon_species	NamedAPIResource	Yes	A Pokémon species that can be the referenced gender.

GrowthRate

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

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
formula	string	Yes	The formula used to calculate the rate at which the Pokémon species gains level.
descriptions	Array<Description>	Yes	The descriptions of this characteristic listed in different languages.
levels	Array<GrowthRateExperienceLevel>	Yes	A list of levels and the amount of experienced needed to atain them based on this growth rate.
pokemon_species	Array<NamedAPIResource>	Yes	A list of Pokémon species that gain levels at this growth rate.

GrowthRateExperienceLevel

Property	Type	Required	Description
level	number	Yes	The level gained.
experience	number	Yes	The amount of experience required to reach the referenced level.

Nature

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

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
decreased_stat	NamedAPIResource	Yes	The stat decreased by 10% in Pokémon with this nature.
increased_stat	NamedAPIResource	Yes	The stat increased by 10% in Pokémon with this nature.
hates_flavor	NamedAPIResource	Yes	The flavor hated by Pokémon with this nature.
likes_flavor	NamedAPIResource	Yes	The flavor liked by Pokémon with this nature.
pokeathlon_stat_changes	NatureStatChange	Yes	A list of Pokéathlon stats this nature effects and how much it effects them.
move_battle_style_preferences	MoveBattleStylePreference	Yes	A list of battle styles and how likely a Pokémon with this nature is to use them in the Battle Palace or Battle Tent.

NatureStatChange

Property	Type	Required	Description
max_change	number	Yes	The amount of change.
pokeathlon_stat	number	Yes	The stat being affected.

MoveBattleStylePreference

Property	Type	Required	Description
low_hp_preference	number	Yes	Chance of using the move, in percent, if HP is under one half.
high_hp_preference	number	Yes	Chance of using the move, in percent, if HP is over one half.
move_battle_style	NamedAPIResource	Yes	The move battle style.

PokeAthlonStat

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
names	Name	Yes	The name of this resource listed in different languages.
affecting_natures	NaturePokeathlonStatAffectSets	Yes	A detail of natures which affect this Pokéathlon stat positively or negatively.

NaturePokeathlonStatAffectSets

Property	Type	Required	Description
increase	Array<NaturePokeathlonStatAffect>	Yes	A list of natures and how they change the referenced Pokéathlon stat.
decrease	Array<NaturePokeathlonStatAffect>	Yes	A list of natures and how they change the referenced Pokéathlon stat.

NaturePokeathlonStatAffect

Property	Type	Required	Description
max_change	number	Yes	The maximum amount of change to the referenced Pokéathlon stat.
nature	NamedAPIResource	Yes	The nature causing the change.

PokemonColor

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	number	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
pokemon_entries	Array<NamedAPIResource>	Yes	A list of the Pokémon species that have this color.

PokemonForm

Some Pokémon may appear in one of multiple, visually different forms. These differences are purely cosmetic. For variations within a Pokémon species, which do differ in more than just visuals, the 'Pokémon' entity is used to represent such a variety.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
order	number	Yes	The 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.
form_order	number	Yes	The order in which forms should be sorted within a species' forms.
is_default	boolean	Yes	True for exactly one form used as the default for each Pokémon.
is_battle_only	boolean	Yes	Whether or not this form can only happen during battle.
is_mega	boolean	Yes	Whether or not this form requires mega evolution.
form_name	string	Yes	The name of this form.
pokemon	Array<NamedAPIResource>	Yes	The Pokémon that can take on this form.
types	Array<PokemonFormType>	Yes	A list of details showing types this Pokémon form has.
sprites	PokemonFormSprites	Yes	A list of details showing types this Pokémon form has.
names	Name	Yes	The form specific full name of this Pokémon form, or empty if the form does not have a specific name.
form_names	Name	Yes	The form specific form name of this Pokémon form, or empty if the form does not have a specific name.
version_group	Array<NamedAPIResource>	Yes	The version group this Pokémon form was introduced in.

PokemonFormType

Property	Type	Required	Description
slot	number	Yes	The order the Pokémon's types are listed in.
type	<NamedAPIResource>	Yes	The type the referenced Form has.

PokemonFormSprites

Property	Type	Required	Description
front_default	string	Yes	The default depiction of this Pokémon form from the front in battle.
back_default	string	Yes	The default depiction of this Pokémon form from the back in battle.
front_shiny	string	Yes	The shiny depiction of this Pokémon form from the front in battle.
back_shiny	string	Yes	The shiny depiction of this Pokémon form from the back in battle.

PokemonHabitat

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

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	number	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
pokemon_entries	Array<NamedAPIResource>	Yes	A list of the Pokémon species that can be found in this habitat.

PokemonLocationArea

Pokémon Location Areas are ares where Pokémon can be found.

Property	Type	Required	Description
location_area	NamedAPIResource	Yes	The location area the referenced Pokémon can be encountered in.
version_details	Array<VersionEncounterDetail>	Yes	A list of versions and encounters with the referenced Pokémon that might happen.

PokemonShape

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

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	number	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
awesome_names	Array<AwesomeName>	Yes	The "scientific" name of this Pokémon shape listed in different languages.
pokemon_species	Array<NamedAPIResource>	Yes	A list of the Pokémon species that can be found in this habitat.

AwesomeName

Property	Type	Required	Description
awesome_name	string	Yes	The localized "scientific" name for an API resource in a specific language.
language	NamedAPIResource	Yes	The language this "scientific" name is in.

PokemonSpecie

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
order	number	Yes	The order in which species should be sorted. Based on National Dex order, except families are grouped together and sorted by stage.
gender_rate	number	Yes	The chance of this Pokémon being female, in eighths; or -1 for genderless.
capture_rate	number	Yes	The happiness when caught by a normal Pokéball; up to 255. The higher the number, the happier the Pokémon.
base_happiness	number	Yes	A detail of natures which affect this stat positively or negatively.
is_baby	boolean	Yes	Whether or not this is a baby Pokémon.
is_legendary	boolean	Yes	Whether or not this is a legendary Pokémon.
is_mythical	boolean	Yes	Whether or not this is a mythical Pokémon.
hatch_counter	number	Yes	One must walk 255 × (hatch_counter + 1) steps before this Pokémon's egg hatches, unless utilizing bonuses like Flame Body's.
has_gender_differences	boolean	Yes	Whether or not this Pokémon has visual gender differences.
forms_switchable	boolean	Yes	Whether or not this Pokémon has multiple forms and can switch between them.
growth_rate	NamedAPIResource	Yes	The rate at which this Pokémon species gains levels.
pokedex_numbers	Array<PokemonSpecieDexEntry>	Yes	A list of Pokedexes and the indexes reserved within them for this Pokémon species.
egg_groups	Array<NamedAPIResource>	Yes	A list of egg groups this Pokémon species is a member of.
color	NamedAPIResource	Yes	The color of this Pokémon for Pokédex search.
shape	NamedAPIResource	Yes	The shape of this Pokémon for Pokédex search.
evolves_from_species	NamedAPIResource	Yes	The Pokémon species that evolves into this Pokemon_species.
evolution_chain	APIResource	Yes	The evolution chain this Pokémon species is a member of.
habitat	NamedAPIResource	Yes	The habitat this Pokémon species can be encountered in.
generation	NamedAPIResource	Yes	The generation this Pokémon species was introduced in.
names	Array<Name>	Yes	The name of this resource listed in different languages.
pal_park_encounters	PalParkEncounterArea	Yes	A list of encounters that can be had with this Pokémon species in pal park.
flavor_text_entries	Array<FlavorText>	Yes	A list of flavor text entries for this Pokémon species.
forms_descriptions	Array<Description>	Yes	Descriptions of different forms Pokémon take on within the Pokémon species.
genera	Genus	Yes	The genus of this Pokémon species listed in multiple languages.
varieties	PokemonSpecieVariety	Yes	A list of the Pokémon that exist within this Pokémon species.

PokemonSpecieDexEntry

Property	Type	Required	Description
entry_number	number	Yes	The index number within the Pokédex.
pokedex	NamedAPIResource	Yes	The Pokédex the referenced Pokémon species can be found in.

PalParkEncounterArea

Property	Type	Required	Description
rate	number	Yes	The base rate for encountering the referenced Pokémon in this pal park area.
area	NamedAPIResource	Yes	The pal park area where this encounter happens.
base_score	number	Yes	The base score given to the player when the referenced Pokémon is caught during a pal park run.

Genus

Property	Type	Required	Description
genus	string	Yes	The localized genus for the referenced Pokémon species.
language	NamedAPIResource	Yes	The language this genus is in.

PokemonSpecieVariety

Property	Type	Required	Description
is_default	boolean	Yes	Whether this variety is the default variety.
pokemon	NamedAPIResource	Yes	The Pokémon variety.

PokemonStat

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	NamedAPIResource	Yes	The name for this resource.
names	Array<Name>	Yes	The name of this resource listed in different languages.
game_index	number	Yes	ID the games use for this stat.
is_battle_only	boolean	Yes	Whether this stat only exists within a battle.
affecting_moves	MoveStatAffectSet	Yes	A detail of moves which affect this stat positively or negatively.
affecting_natures	NatureStatAffectSet	Yes	A detail of natures which affect this stat positively or negatively.
characteristics	Array<APIResource>	Yes	A list of characteristics that are set on a Pokémon when its highest base stat is this stat.
move_damage_class	NamedAPIResource	Yes	The class of damage this stat is directly related to.

MoveStatAffectSet

Property	Type	Required	Description
increase	Array<MoveStatAffect>	Yes	A list of moves and how they change the referenced stat.
decrease	Array<MoveStatAffect>	Yes	A list of moves and how they change the referenced stat.

MoveStatAffect

Property	Type	Required	Description
change	number	Yes	The maximum amount of change to the referenced stat.
move	NamedAPIResource	Yes	The move causing the change.

NatureStatAffectSet

Property	Type	Required	Description
increase	Array<NamedAPIResource>	Yes	A list of natures and how they change the referenced stat.
decrease	Array<NamedAPIResource>	Yes	A list of nature sand how they change the referenced stat.

PokemonType

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.

Property	Type	Required	Description
id	number	Yes	The identifier for this resource.
name	string	Yes	The name for this resource.
damage_relations	TypeRelations	Yes	A detail of how effective this type is toward others and vice versa.
past_damage_relations	Array<TypeRelationsPast>	Yes	A list of details of how effective this type was toward others and vice versa in previous generations.
game_indices	Array<GenerationGameIndex>	Yes	A list of game indices relevent to this item by generation.
generation	NamedAPIResource	Yes	The generation this type was introduced in.
move_damage_class	NamedAPIResource	Yes	The class of damage inflicted by this type.
names	Array<Name>	Yes	The name of this resource listed in different languages.
pokemon	Array<TypePokemon>	Yes	A list of details of Pokémon that have this type.
moves	Array<NamedAPIResource>	Yes	A list of moves that have this type.

TypePokemon

Property	Type	Required	Description
slot	number	Yes	The order the Pokémon's types are listed in.
pokemon	NamedAPIResource	Yes	The Pokémon that has the referenced type.

TypeRelations

Property	Type	Required	Description
no_damage_to	Array<NamedAPIResource>	Yes	A list of types this type has no effect on.
half_damage_to	Array<NamedAPIResource>	Yes	A list of types this type is not very effect against.
double_damage_to	Array<NamedAPIResource>	Yes	A list of types this type is very effect against.
no_damage_from	Array<NamedAPIResource>	Yes	A list of types that have no effect on this type.
half_damage_from	Array<NamedAPIResource>	Yes	A list of types that are not very effective against this type.
double_damage_from	Array<NamedAPIResource>	Yes	A list of types that are very effective against this type.

TypeRelationsPast

Property	Type	Required	Description
generation	NamedAPIResource	Yes	The last generation in which the referenced type had the listed damage relations.
damage_relations	TypeRelations	Yes	The damage relations the referenced type had up to and including the listed generation.