mirror of https://github.com/PokeAPI/pokeapi synced 2024-11-24 20:33:04 +00:00

History

indyandie da11f734db fix: add `evolution-chain` schema_field definitions		2024-03-03 22:29:50 -06:00
..
migrations	style: Run black formatter on source	2024-02-03 00:32:51 +05:30
__init__.py	initial commit	2014-12-04 11:11:46 +00:00
api.py	docs: update summary	2024-03-01 03:57:22 -06:00
models.py	style: Run black formatter on source	2024-02-03 00:32:51 +05:30
README.md	fixed a typo in docs	2023-06-15 12:45:20 +03:00
serializers.py	fix: add `evolution-chain` schema_field definitions	2024-03-03 22:29:50 -06:00
test_models.py	Autoformat entire project, tidy up makefile	2020-02-24 13:18:14 +13:00
tests.py	style: Run black formatter on source	2024-02-03 00:32:51 +05:30
urls.py	Autoformat entire project, tidy up makefile	2020-02-24 13:18:14 +13:00

README.md

Pokeapi V2 API Reference

API Endpoints
Abilities Berries Berry Firmnesses Berry Flavors Characteristics Contest Types Contest Effects Egg Groups Encounter Methods Encounter Conditions Encounter Condition Values Evolution Chains Evolution Triggers Generations Genders Growth Rates	Items Item Categories Item Attributes Item Fling Effects Item Pockets Languages Locations Location Areas Moves Move Ailments Move Battle Styles Move Categories Move Damage Classes Move Learn Methods Move Targets Natures	Pal Park Areas Pokédexes Pokémon Pokémon Colors Pokémon Forms Pokémon Habitats Pokémon Shapes Pokémon Species Pokéathlon Stats Regions Stats Super Contest Effects Types Versions Version Groups

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 param, e.g. limit=60.

GET api/v2/{endpoint}

example response for non-named resources

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

APIResourceList

Name	Description	Data Type
count	The total number of resources available from this api	integer
next	The url for the next 'page' in the list	string
previous	The url for the previous page in the list	boolean
results	The list of non-named api resources	list APIResource

example response for named resources

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

NamedAPIResourceList

Name	Description	Data Type
count	The total number of resources available from this api	integer
next	The url for the next 'page' in the list	string
previous	The url for the previous page in the list	boolean
results	The list of named api resources	list NamedAPIResource

Berries

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

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

example response

{
	"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": "http://pokeapi.co/api/v2/berry-firmness/2/"
	},
	"flavors": [{
		"potency": 10,
		"flavor": {
			"name": "spicy",
			"url": "http://pokeapi.co/api/v2/berry-flavor/1/"
		}
	}],
	"item": {
		"name": "cheri-berry",
		"url": "http://pokeapi.co/api/v2/item/126/"
	},
	"natural_gift_type": {
		"name": "fire",
		"url": "http://pokeapi.co/api/v2/type/10/"
	}
}

response models

Berry

Name	Description	Data Type
id	The identifier for this berry resource	integer
name	The name for this berry resource	string
growth_time	Time 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_harvest	The maximum number of these berries that can grow on one tree in Generation IV	integer
natural_gift_power	The power of the move "Natural Gift" when used with this Berry	integer
size	The size of this Berry, in millimeters	integer
smoothness	The smoothness of this Berry, used in making Pokéblocks or Poffins	integer
soil_dryness	The speed at which this Berry dries out the soil as it grows. A higher rate means the soil dries more quickly.	integer
firmness	The firmness of this berry, used in making Pokéblocks or Poffins	NamedAPIResource (BerryFirmness)
flavors	A 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
item	Berries are actually items. This is a reference to the item specific data for this berry.	NamedAPIResource (Item)
natural_gift_type	The Type the move "Natural Gift" has when used with this Berry	NamedAPIResource (Type)

BerryFlavorMap

Name	Description	Data Type
potency	How powerful the referenced flavor is for this berry	integer
flavor	The referenced berry flavor	NamedAPIResource (BerryFlavor)

Berry Firmnesses

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

example response

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

response models

BerryFirmness

Name	Description	Data Type
id	The identifier for this berry firmness resource	integer
name	The name for this berry firmness resource	string
berries	A list of the berries with this firmness	list NamedAPIResource (Berry)
names	The name of this berry firmness listed in different languages	list Name

Berry Flavors

Flavors determine whether a pokemon 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}

example response

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

response models

BerryFlavor

Name	Description	Data Type
id	The identifier for this berry flavor resource	integer
name	The name for this berry flavor resource	string
berries	A list of the berries with this flavor	list FlavorBerryMap
contest_type	The contest type that correlates with this berry flavor	NamedAPIResource (ContestType)
names	The name of this berry flavor listed in different languages	list Name

FlavorBerryMap

Name	Description	Data Type
potency	How powerful the referenced flavor is for this berry	integer
berry	The berry with the referenced flavor	NamedAPIResource (Berry)

Contests

Contest Types

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

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

example response

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

response models

ContestType

Name	Description	Data Type
id	The identifier for this contest type resource	integer
name	The name for this contest type resource	string
berry_flavor	The berry flavor that correlates with this contest type	NamedAPIResource (BerryFlavor)
names	The name of this contest type listed in different languages	list Name

Contest Effects

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

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

example response

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

response models

ContestEffect

Name	Description	Data Type
id	The identifier for this contest type resource	integer
appeal	The base number of hearts the user of this move gets	string
jam	The base number of hearts the user's opponent loses	integer
effect_entries	The result of this contest effect listed in different languages	list Effect
flavor_text_entries	The 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}

example response

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

response models

SuperContestEffect

Name	Description	Data Type
id	The identifier for this super contest effect resource	integer
appeal	The level of appeal this super contest effect has	string
flavor_text_entries	The flavor text of this super contest effect listed in different languages	list FlavorText
moves	A list of moves that have the effect when used in super contests	list NamedAPIResource (Move)

Encounters

Encounter Methods

Methods by which the player 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}

example response

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

response models

EncounterMethod

Name	Description	Data Type
id	The identifier for this encounter method resource	integer
name	The name for this encounter method resource	string
order	A good value for sorting	integer
names	The name of this encounter method listed in different languages	list Name

Encounter Conditions

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

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

example response

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

response models

EncounterCondition

Name	Description	Data Type
id	The identifier for this encounter condition resource	integer
name	The name for this encounter condition resource	string
names	The name of this encounter method listed in different languages	list Name
values	A 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}

example response

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

response models

EncounterConditionValue

Name	Description	Data Type
id	The identifier for this encounter condition value resource	integer
name	The name for this encounter condition value resource	string
condition	The condition this encounter condition value pertains to	list NamedAPIResource (EncounterCondition)
names	The name of this encounter condition value 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}

example response

{
	"id": 7,
	"baby_trigger_item": null,
	"chain": {
		"is_baby": false,
		"species": {
			"name": "rattata",
			"url": "http://pokeapi.co/api/v2/pokemon-species/19/"
		},
		"evolution_details": null,
		"evolves_to": [{
			"is_baby": false,
			"species": {
				"name": "raticate",
				"url": "http://pokeapi.co/api/v2/pokemon-species/20/"
			},
			"evolution_details": {
				"item": null,
				"trigger": {
					"name": "level-up",
					"url": "http://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": []
		}]
	}
}

response models

EvolutionChain

Name	Description	Data Type
id	The identifier for this evolution chain resource	integer
baby_trigger_item	The 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)
chain	The 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

ChainLink

Name	Description	Data Type
is_baby	Whether or not this link is for a baby pokémon. This would only ever be true on the base link.	boolean
species	The pokemon species at this point in the evolution chain	NamedAPIResource (PokemonSpecies)
evolution_details	All details regarding the specific details of the referenced pokémon species evolution	EvolutionDetail
evolves_to	A List of chain objects.	list ChainLink

EvolutionDetail

Name	Description	Data Type
item	The item required to cause evolution this into pokémon species	NamedAPIResource (Item)
trigger	The type of event that triggers evolution into this pokémon species	NamedAPIResource (EvolutionTrigger)
gender	The gender the evolving pokémon species must be in order to evolve into this pokémon species	NamedAPIResource (Gender)
held_item	The item the evolving pokémon species must be holding during the evolution trigger event to evolve into this pokémon species	NamedAPIResource (Item)
known_move	The 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_type	The 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)
location	The location the evolution must be triggered at.	NamedAPIResource (Location)
min_level	The minimum required level of the evolving pokémon species to evolve into this pokémon species	integer
min_happiness	The minimum required level of happiness the evolving pokémon species to evolve into this pokémon species	integer
min_beauty	The minimum required level of beauty the evolving pokémon species to evolve into this pokémon species	integer
min_affection	The minimum required level of affection the evolving pokémon species to evolve into this pokémon species	integer
needs_overworld_rain	Whether or not it must be raining in the overworld to cause evolution this pokémon species	boolean
party_species	The 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_type	The 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_stats	The 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_day	The required time of day. Day or night.	string
trade_species	Pokémon species for which this one must be traded.	NamedAPIResource (Pokémon Species)
turn_upside_down	Whether 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}

example response

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

response models

EvolutionTrigger

Name	Description	Data Type
id	The identifier for this evolution trigger resource	integer
name	The name for this evolution trigger resource	string
names	The name of this evolution trigger listed in different languages	list Name
pokemon_species	A list of pokémon 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}

example response

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

response models

Generation

Name	Description	Data Type
id	The identifier for this generation resource	integer
name	The name for this generation resource	string
abilities	A list of abilities that were introduced in this generation	list NamedAPIResource (Ability)
names	The name of this generation listed in different languages	list Name
main_region	The main region travelled in this generation	NamedAPIResource (Region)
moves	A list of moves that were introduced in this generation	list NamedAPIResource (Move)
pokemon_species	A list of pokémon species that were introduced in this generation	list NamedAPIResource (PokemonSpecies)
types	A list of types that were introduced in this generation	list NamedAPIResource (Type)
version_groups	A 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. (Note: no official plural of 'pokédex' is known, 'standard' -(e)s is used here)

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

example response

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

response models

Pokedex

Name	Description	Data Type
id	The identifier for this pokédex resource	integer
name	The name for this pokédex resource	string
is_main_series	Whether or not this pokédex originated in the main series of the video games	boolean
descriptions	The description of this pokédex listed in different languages	list Description
names	The name of this pokédex listed in different languages	list Name
pokemon_entries	A list of pokémon catalogued in this pokédex and their indexes	list PokemonEntry
region	The region this pokédex catalogues pokémon for	NamedAPIResource (Region)
version_groups	A list of version groups this pokédex is relevent to	list NamedAPIResource (VersionGroup)

PokemonEntry

Name	Description	Data Type
entry_number	The index of this pokémon species entry within the pokédex	integer
pokemon_species	The pokémon species being encountered	NamedAPIResource (PokemonSpecies)

Versions

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

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

example response


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

response models

Version

Name	Description	Data Type
id	The identifier for this version resource	integer
name	The name for this version resource	string
names	The name of this version listed in different languages	list Name
version_group	The 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}

example response

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

response models

VersionGroup

Name	Description	Data Type
id	The identifier for this version group resource	integer
name	The name for this version group resource	string
order	Order for sorting. Almost by date of release, except similar versions are grouped together.	integer
generation	The generation this version was introduced in	list NamedAPIResource (Generation)
move_learn_methods	A list of methods in which pokemon can learn moves in this version group	list NamedAPIResource (MoveLearnMethod)
names	The name of this version group listed in different languages	list Name
pokedexes	A list of pokedexes introduces in this version group	list NamedAPIResource (Pokedex)
regions	A list of regions that can be visited in this version group	list NamedAPIResource (Region)
versions	The versions this version group owns	list NamedAPIResource (Version)

Items

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}

example response

{
	"id": 1,
	"name": "master-ball",
	"cost": 0,
	"fling_power": 10,
	"fling_effect": {
		"name":"flinch",
		"url":"http://pokeapi.co/api/v2/item-fling-effect/7/"
	},
	"attributes": [{
		"name": "holdable",
		"url": "http://pokeapi.co/api/v2/item-attribute/5/"
	}],
	"category": {
		"name": "standard-balls",
		"url": "http://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": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"flavor_text_entries": [{
		"text": "é‡Žç”Ÿã®ã€€ãƒã‚±ãƒ¢ãƒ³ã‚’ã€€å¿…ãš\næ•ã¾ãˆã‚‹ã“ã¨ãŒã€€ã§ãã‚‹\næœ€é«˜ã€€æ€§èƒ½ã®ã€€ãƒœãƒ¼ãƒ«ã€‚",
		"version_group": {
			"name": "x-y",
			"url": "http://pokeapi.co/api/v2/version-group/15/"
		},
		"language": {
			"name": "ja-kanji",
			"url": "http://pokeapi.co/api/v2/language/11/"
		}
	}],
	"game_indices": [{
		"game_index": 1,
		"generation": {
			"name": "generation-vi",
			"url": "http://pokeapi.co/api/v2/generation/6/"
		}
	}],
	"names": [{
		"name": "Master Ball",
		"language": {
			"name": "en",
			"url": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"held_by_pokemon": [{
		"pokemon": {
			"name": "chansey",
			"url": "http://pokeapi.co/api/v2/pokemon/113/"
		},
		"version_details": [{
			"rarity": 50,
			"version": {
				"name": "soulsilver",
				"url": "http://pokeapi.co/api/v2/version/16/"
			}
		}]
	}],
	"baby_trigger_for": {
		"url":"http://pokeapi.co/api/v2/evolution-chain/1/"
	}
}

response models

Item

Name	Description	Data Type
id	The identifier for this item resource	integer
name	The name for this item resource	string
cost	The price of this item in stores	integer
fling_power	The power of the move Fling when used with this item.	integer
fling_effect	The effect of the move Fling when used with this item	ItemFlingEffect
attributes	A list of attributes this item has	list NamedAPIResource (ItemAttribute)
category	The category of items this item falls into	ItemCategory
effect_entries	The effect of this ability listed in different languages	list VerboseEffect
flavor_text_entries	The flavor text of this ability listed in different languages	list VersionGroupFlavorText
game_indices	A list of game indices relevent to this item by generation	list GenerationGameIndex
names	The name of this item listed in different languages	list Name
held_by_pokemon	A list of pokémon that might be found in the wild holding this item	list HeldByPokemon
baby_trigger_for	An evolution chain this item requires to produce a bay during mating	list APIResource (EvolutionChain)

HeldByPokemon

Name	Description	Data Type
pokemon	The pokemon who might be holding the item	NamedAPIResource (Pokemon)
version_details	Details on chance of the pokemon having the item based on version	list VersionDetails

HeldItemVersionDetails

Name	Description	Data Type
rarity	The chance of the pokemon holding the item	integer
version	The version the rarity applies	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}

example response

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

response models

ItemAttribute

Name	Description	Data Type
id	The identifier for this item attribute resource	integer
name	The name for this item attribute resource	string
items	A list of items that have this attribute	list NamedAPIResource (Item)
names	The name of this item attribute listed in different languages	list Name
descriptions	The 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}

example response

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

response models

ItemCategory

Name	Description	Data Type
id	The identifier for this item category resource	integer
name	The name for this item category resource	string
items	A list of items that are a part of this category	list NamedAPIResource (Item)
names	The name of this item category listed in different languages	list Name
pocket	The 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}

example response

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

response models

ItemFlingEffect

Name	Description	Data Type
id	The identifier for this fling effect resource	integer
name	The name for this fling effect resource	string
effect_entries	The result of this fling effect listed in different languages	list Effect
items	A list of items that have this fling effect	list NamedAPIResource (Item)

Item Pockets

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

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

example response

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

response models

ItemPocket

Name	Description	Data Type
id	The identifier for this item pocket resource	integer
name	The name for this item pocket resource	string
categories	A list of item categories that are relevent to this item pocket	list NamedAPIResource (ItemCategory)
names	The name of this item pocket listed in different languages	list Name

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}

example response

{
	"id": 1,
	"name": "pound",
	"accuracy": 100,
	"effect_chance": null,
	"pp": 35,
	"priority": 0,
	"power": 40,
	"contest_combos": {
		"normal": {
			"use_before": [{
				"name": "double-slap",
				"url": "http://pokeapi.co/api/v2/move/3/"
			}, {
				"name": "headbutt",
				"url": "http://pokeapi.co/api/v2/move/29/"
			}, {
				"name": "feint-attack",
				"url": "http://pokeapi.co/api/v2/move/185/"
			}],
			"use_after": null
		},
		"super": {
			"use_before": null,
			"use_after": null
		}
	},
	"contest_type": {
		"name": "tough",
		"url": "http://pokeapi.co/api/v2/contest-type/5/"
	},
	"contest_effect": {
		"url": "http://pokeapi.co/api/v2/contest-effect/1/"
	},
	"damage_class": {
		"name": "physical",
		"url": "http://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": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"effect_changes": [],
	"generation": {
		"name": "generation-i",
		"url": "http://pokeapi.co/api/v2/generation/1/"
	},
	"meta": {
		"ailment": {
			"name": "none",
			"url": "http://pokeapi.co/api/v2/move-ailment/0/"
		},
		"category": {
			"name": "damage",
			"url": "http://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": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"past_values": [],
	"stat_changes": [],
	"super_contest_effect": {
		"url": "http://pokeapi.co/api/v2/super-contest-effect/5/"
	},
	"target": {
		"name": "selected-pokemon",
		"url": "http://pokeapi.co/api/v2/move-target/10/"
	},
	"type": {
		"name": "normal",
		"url": "http://pokeapi.co/api/v2/type/1/"
	}
}

response models

Move

Name	Description	Data Type
id	The identifier for this move resource	integer
name	The name for this move resource	string
accuracy	The percent value of how likely this move is to be successful	integer
effect_chance	The percent value of how likely it is this moves effect will happen	integer
pp	Power points. The number of times this move can be used	integer
priority	A value between -8 and 8. Sets the order in which moves are executed during battle. See Bulbapedia for greater detail.	integer
power	The base power of this move with a value of 0 if it does not have a base power	integer
contest_combos	A detail of normal and super contest combos that require this move	list ContestComboSets
contest_type	The type of appeal this move gives a pokémon when used in a contest	NamedAPIResource (ContestType)
contest_effect	The effect the move has when used in a contest	NamedAPIResource (ContestEffect)
damage_class	The type of damage the move inflicts on the target, e.g. physical	NamedAPIResource (MoveDamageClass)
effect_entries	The effect of this move listed in different languages	list VerboseEffect
effect_changes	The list of previous effects this move has had across version groups of the games	list AbilityEffectChange
generation	The generation in which this move was introduced	NamedAPIResource (Generation)
meta	Meta data about this move	MoveMetaData
names	The name of this move listed in different languages	list Name
past_values	A list of move resource value changes across ersion groups of the game	list PastMoveStatValues
stat_changes	A list of stats this moves effects and how much it effects them	list MoveStatChange
super_contest_effect	The effect the move has when used in a super contest	NamedAPIResource (ContestEffect)
target	The type of target that will recieve the effects of the attack	NamedAPIResource (MoveTarget)
type	The elemental type of this move	NamedAPIResource (Type)

ContestComboSets

Name	Description	Data Type
normal	A detail of moves this move can be used before or after, granting additional appeal points in contests	list ContestComboDetail
super	A detail of moves this move can be used before or after, granting additional appeal points in super contests	list ContestComboDetail

ContestComboDetail

Name	Description	Data Type
use_before	A list of moves to use before this move	list NamedAPIResource (Move)
use_after	A list of moves to use after this move	list NamedAPIResource (Move)

MoveMetaData

Name	Description	Data Type
ailment	The status ailment this move inflicts on its target	NamedAPIResource (MoveAilment)
category	The category of move this move falls under, e.g. damage or ailment	NamedAPIResource (Move)
min_hits	The minimum number of times this move hits. Null if it always only hits once.	integer
max_hits	The maximum number of times this move hits. Null if it always only hits once.	integer
min_turns	The minimum number of turns this move continues to take effect. Null if it always only lasts one turn.	integer
max_turns	The maximum number of turns this move continues to take effect. Null if it always only lasts one turn.	integer
drain	HP drain (if positive) or Recoil damage (if negative), in percent of damage done	integer
healing	The amount of hp gained by the attacking pokémon, in percent of it's maximum HP	integer
crit_rate	Critical hit rate bonus	integer
ailment_chance	The likelyhood this attack will cause an ailment	integer
flinch_chance	The likelyhood this attack will cause the target pokémon to flinch	integer
stat_chance	The likelyhood this attack will cause a stat change in the target pokémon	integer

MoveStatChange

Name	Description	Data Type
change	The amount of change	integer
stat	The stat being affected	NamedAPIResource (Stat)

PastMoveStatValues

Name	Description	Data Type
accuracy	The percent value of how likely this move is to be successful	integer
effect_chance	The percent value of how likely it is this moves effect will take effect	integer
power	The base power of this move with a value of 0 if it does not have a base power	integer
pp	Power points. The number of times this move can be used	integer
effect_entries	The effect of this move listed in different languages	list VerboseEffect
type	The elemental type of this move	NamedAPIResource (Type)
version group	The 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}

example response

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

response models

Move Ailment

Name	Description	Data Type
id	The identifier for this move ailment resource	integer
name	The name for this move ailment resource	string
moves	A list of moves that cause this ailment	list NamedAPIResource (Move)
names	The name of this move ailment 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}

example response

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

response models

Move Battle Style

Name	Description	Data Type
id	The identifier for this move battle style resource	integer
name	The name for this move battle style resource	string
names	The name of this move battle style listed in different languages	list Name

Move Categories

Very general categories that loosely group move effects.

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

example response

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

response models

Move Category

Name	Description	Data Type
id	The identifier for this move category resource	integer
name	The name for this move category resource	string
moves	A list of moves that fall into this category	list NamedAPIResource (Move)
descriptions	The description of this move ailment listed in different languages	list Description

Move Damage Classes

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

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

example response

{
	"id": 1,
	"name": "status",
	"descriptions": [{
		"description": "ãƒ€ãƒ¡ãƒ¼ã‚¸ãªã„",
		"language": {
			"name": "ja",
			"url": "http://pokeapi.co/api/v2/language/1/"
		}
	}],
	"moves": [{
		"name": "swords-dance",
		"url": "http://pokeapi.co/api/v2/move/14/"
	}]
}

response models

Move Damage Class

Name	Description	Data Type
id	The identifier for this move damage class resource	integer
name	The name for this move damage class resource	string
descriptions	The description of this move damage class listed in different languages	list Description
moves	A list of moves that fall into this damage class	list NamedAPIResource (Move)
names	The name of this move damage class 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}

example response

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

response models

Move Learn Method

Name	Description	Data Type
id	The identifier for this move learn method resource	integer
name	The name for this move learn method resource	string
descriptions	The description of this move learn method listed in different languages	list Description
names	The name of this move learn method listed in different languages	list Name
version_groups	A 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}

example response

{
	"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": "http://pokeapi.co/api/v2/language/6/"
		}
	}],
	"moves": [{
		"name": "counter",
		"url": "http://pokeapi.co/api/v2/move/68/"
	}],
	"names": [{
		"name": "Spezifische FÃ¤higkeit",
		"language": {
			"name": "de",
			"url": "http://pokeapi.co/api/v2/language/6/"
		}
	}]
}

response models

Move Target

Name	Description	Data Type
id	The identifier for this move target resource	integer
name	The name for this move target resource	string
descriptions	The description of this move target listed in different languages	list Description
moves	A list of moves that that are directed at this target	list NamedAPIResource (Move)
names	The name of this move target listed in different languages	list Name

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}

example response

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

response models

Location

Name	Description	Data Type
id	The identifier for this location resource	integer
name	The name for this location resource	string
region	The region this location can be found in	NamedAPIResource (Region)
names	The name of this language listed in different languages	list Name
game_indices	A list of game indices relevent to this location by generation	list GenerationGameIndex
areas	Areas that can be found within this location	APIResource (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 pokemon encounters.

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

example response

{
	"id": 1,
	"name": "canalave-city-area",
	"game_index": 1,
	"encounter_method_rates": [{
		"encounter_method": {
			"name": "old-rod",
			"url": "http://pokeapi.co/api/v2/encounter-method/2/"
		},
		"version_details": [{
			"rate": 25,
			"version": {
				"name": "platinum",
				"url": "http://pokeapi.co/api/v2/version/14/"
			}
		}]
	}],
	"location": {
		"name": "canalave-city",
		"url": "http://pokeapi.co/api/v2/location/1/"
	},
	"names": [{
		"name": "",
		"language": {
			"name": "en",
			"url": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"pokemon_encounters": [{
		"pokemon": {
			"name": "tentacool",
			"url": "http://pokeapi.co/api/v2/pokemon/72/"
		},
		"version_details": [{
			"version": {
				"name": "diamond",
				"url": "http://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": "http://pokeapi.co/api/v2/encounter-method/5/"
				}
			}]
		}]
	}]
}

response models

LocationArea

Name	Description	Data Type
id	The identifier for this location resource	integer
name	The name for this location resource	string
game_index	The internal id of an api resource within game data	integer
encounter_method_rates	A 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
location	The region this location can be found in	NamedAPIResource (Region)
names	The name of this location area listed in different languages	list Name
pokemon_encounters	A list of pokémon that can be encountered in this area along with version specific details about the encounter	list PokemonEncounter

EncounterMethodRate

Name	Description	Data Type
encounter_method	The method in which pokémon may be encountered in an area.	EncounterMethod
version_details	The chance of the encounter to occur on a version of the game.	list EncounterVersionDetails

EncounterVersionDetails

Name	Description	Data Type
rate	The chance of an encounter to occur.	integer
version	The version of the game in which the encounter can occur with the given chance.	NamedAPIResource (Version)

PokemonEncounter

Name	Description	Data Type
pokemon	The pokémon being encountered	NamedAPIResource (Pokemon)
version_details	A 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}

example response

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

response models

PalParkArea

Name	Description	Data Type
id	The identifier for this pal park area resource	integer
name	The name for this pal park area resource	string
names	The name of this pal park area listed in different languages	list Name
pokemon_encounters	A list of pokémon encountered in thi pal park area along with details	list PalParkEncounterSpecies

PalParkEncounterSpecies

Name	Description	Data Type
base_score	The base score given to the player when this pokémon is caught during a pal park run	integer
rate	The base rate for encountering this pokémon in this pal park area	integer
pokemon_species	The 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}

example response

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

response models

Region

Name	Description	Data Type
id	The identifier for this region resource	integer
name	The name for this region resource	string
locations	A list of locations that can be found in this region	NamedAPIResource (Location)
main_generation	The generation this region was introduced in	NamedAPIResource (Generation)
names	The name of this region listed in different languages	list Name
pokedexes	A list of pokédexes that catalogue pokemon in this region	list NamedAPIResource (Pokedex)
version_groups	A list of version groups where this region can be visited	list NamedAPIResource (VersionGroup)

Pokemon

Abilities

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

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

example response

{
	"id": 1,
	"name": "stench",
	"is_main_series": true,
	"generation": {
		"name": "generation-iii",
		"url": "http://pokeapi.co/api/v2/generation/3/"
	},
	"names": [{
		"name": "Stench",
		"language": {
			"name": "en",
			"url": "http://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": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"effect_changes": [{
		"version_group": {
			"name": "black-white",
			"url": "http://pokeapi.co/api/v2/version-group/11/"
		},
		"effect_entries": [{
			"effect": "Has no effect in battle.",
			"language": {
				"name": "en",
				"url": "http://pokeapi.co/api/v2/language/9/"
			}
		}]
	}],
	"flavor_text_entries": [{
		"flavor_text": "è‡ãã¦ã€€ç›¸æ‰‹ãŒ\nã²ã‚‹ã‚€ã€€ã“ã¨ãŒã‚ã‚‹ã€‚",
		"language": {
			"name": "ja-kanji",
			"url": "http://pokeapi.co/api/v2/language/11/"
		},
		"version_group": {
			"name": "x-y",
			"url": "http://pokeapi.co/api/v2/version-group/15/"
		}
	}],
	"pokemon": [{
		"is_hidden": true,
		"slot": 3,
		"pokemon": {
			"name": "gloom",
			"url": "http://pokeapi.co/api/v2/pokemon/44/"
		}
	}]
}

response models

Ability

Name	Description	Data Type
id	The identifier for this ability resource	integer
name	The name for this ability resource	string
is_main_series	Whether or not this ability originated in the main series of the video games	boolean
generation	The generation this ability originated in	NamedAPIResource (Generation)
names	The name of this ability listed in different languages	list Name
effect_entries	The effect of this ability listed in different languages	list VerboseEffect
effect_changes	The list of previous effects this ability has had across version groups	list AbilityEffectChange
flavor_text_entries	The flavor text of this ability listed in different languages	list VersionGroupFlavorText
pokemon	A list of pokémon that could potentially have this ability	list AbilityPokemon

AbilityEffectChange

Name	Description	Data Type
effect_entries	The previous effect of this ability listed in different languages	Effect
version_group	The version group in which the previous effect of this ability originated	NamedAPIResource (VersionGroup)

AbilityFlavorText

Name	Description	Data Type
flavor_text	The localized name for an api resource in a specific language	string
language	The language this name is in	NamedAPIResource (Language)
version_group	The version group that uses this flavor text	NamedAPIResource (VersionGroup)

AbilityPokemon

Name	Description	Data Type
is_hidden	Whether or not this a hidden ability for the referenced pokémon	boolean
slot	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.	integer
pokemon	The 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}

example response

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

response models

Characteristic

Name	Description	Data Type
id	The identifier for this characteristic resource	integer
gene_modulo	The remainder of the highest stat/IV divided by 5	integer
possible_values	The possible values of the highest stat that would result in a pokémon recieving this characteristic when divided by 5	list integer
descriptions	The descriptions of this characteristic listed in different languages	list Description

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}

example response

{
	"id": 1,
	"name": "monster",
	"names": [{
		"name": "ã‹ã„ã˜ã‚…ã†",
		"language": {
			"name": "ja",
			"url": "http://pokeapi.co/api/v2/language/1/"
		}
	}],
	"pokemon_species": [{
		"name": "bulbasaur",
		"url": "http://pokeapi.co/api/v2/pokemon-species/1/"
	}]
}

response models

EggGroup

Name	Description	Data Type
id	The identifier for this egg group resource	integer
name	The name for this egg group resource	string
names	The name of this egg group listed in different languages	list Name
pokemon_species	A 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}

example response

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

response models

Gender

Name	Description	Data Type
id	The identifier for this gender resource	integer
name	The name for this gender resource	string
pokemon_species_details	A list of pokémon species that can be this gender and how likely it is that they will be	list PokemonSpeciesGender
required_for_evolution	A list of pokémon species that required this gender in order for a pokémon to evolve into them	list NamedAPIResource (PokemonSpecies)

PokemonSpeciesGender

Name	Description	Data Type
rate	The chance of this Pokémon being female, in eighths; or -1 for genderless	integer
pokemon_species	A pokemon 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}

example response

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

response models

Growth Rate

Name	Description	Data Type
id	The identifier for this gender resource	integer
name	The name for this gender resource	string
formula	The formula used to calculate the rate at which the pokémon species gains level	string
descriptions	The descriptions of this characteristic listed in different languages	list Description
levels	A list of levels and the amount of experienced needed to atain them based on this growth rate	list GrowthRateExperienceLevel
pokemon_species	A list of pokémon species that gain levels at this growth rate	list NamedAPIResource (PokemonSpecies)

GrowthRateExperienceLevel

Name	Description	Data Type
level	The level gained	integer
experience	The 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}

example response

{
	"id": 2,
	"name": "bold",
	"decreased_stat": {
		"name": "attack",
		"url": "http://pokeapi.co/api/v2/stat/2/"
	},
	"increased_stat": {
		"name": "defense",
		"url": "http://pokeapi.co/api/v2/stat/3/"
	},
	"likes_flavor": {
		"name": "sour",
		"url": "http://pokeapi.co/api/v2/berry-flavor/5/"
	},
	"hates_flavor": {
		"name": "spicy",
		"url": "http://pokeapi.co/api/v2/berry-flavor/1/"
	},
	"pokeathlon_stat_changes": [{
		"max_change": -2,
		"pokeathlon_stat": {
			"name": "speed",
			"url": "http://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": "http://pokeapi.co/api/v2/move-battle-style/1/"
		}
	}],
	"names": [{
		"name": "ãšã¶ã¨ã„",
		"language": {
			"name": "ja",
			"url": "http://pokeapi.co/api/v2/language/1/"
		}
	}]
}

response models

Nature

Name	Description	Data Type
id	The identifier for this nature resource	integer
name	The name for this nature resource	string
decreased_stat	The stat decreased by 10% in pokémon with this nature	NamedAPIResource (Stat)
increased_stat	The stat increased by 10% in pokémon with this nature	NamedAPIResource (Stat)
hates_flavor	The flavor hated by pokémon with this nature	NamedAPIResource (BerryFlavor)
likes_flavor	The flavor liked by pokémon with this nature	NamedAPIResource (BerryFlavor)
pokeathlon_stat_changes	A list of pokéathlon stats this nature effects and how much it effects them	list NatureStatChange
move_battle_style_preferences	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.	list MoveBattleStylePreference
names	The name of this nature listed in different languages	list Name

NatureStatChange

Name	Description	Data Type
change	The amount of change	integer
stat	The stat being affected	NamedAPIResource (PokeathlonStat)

MoveBattleStylePreference

Name	Description	Data Type
low_hp_preference	Chance of using the move, in percent, if HP is under one half	integer
high_hp_preference	Chance of using the move, in percent, if HP is over one half	integer
move_battle_style	The move battle style	NamedAPIResource (MoveBattleStyle)

Pokéathlon Stats

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

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

example response

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

response models

PokeathlonStat

Name	Description	Data Type
id	The identifier for this pokéathlon stat resource	integer
name	The name for this pokéathlon stat resource	string
names	The name of this pokéathlon stat listed in different languages	list Name
affecting_natures	A detail of natures which affect this pokéathlon stat positively or negatively	NaturePokeathlonStatAffectSets

NaturePokeathlonStatAffectSets

Name	Description	Data Type
increase	A list of natures and how they change the referenced pokéathlon stat	list NaturePokeathlonStatAffect
decrease	A list of natures and how they change the referenced pokéathlon stat	list NaturePokeathlonStatAffect

NaturePokeathlonStatAffect

Name	Description	Data Type
max_change	The maximum amount of change to the referenced pokéathlon stat	integer
nature	The nature causing the change	NamedAPIResource (Nature)

Pokémon

Pokémon are the creatures that inhabit the world of the pokemon 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}

example response

{
	"id": 35,
    "name": "clefairy",
    "base_experience": 113,
    "height": 6,
    "is_default": true,
    "order": 56,
    "weight": 75,
    "abilities": [{
		"is_hidden": true,
		"slot": 3,
		"ability": {
			"name": "friend-guard",
			"url": "https://pokeapi.co/api/v2/ability/132/"
		}
	}],
	"forms": [{
		"name": "clefairy",
		"url": "https://pokeapi.co/api/v2/pokemon-form/35/"
	}],
	"game_indices": [{
		"game_index": 35,
		"version": {
			"name": "white-2",
			"url": "https://pokeapi.co/api/v2/version/22/"
		}
	}],
	"held_items": [{
		"item": {
			"name": "moon-stone",
			"url": "https://pokeapi.co/api/v2/item/81/"
		},
		"version_details": [{
			"rarity": 5,
			"version": {
				"name": "ruby",
				"url": "https://pokeapi.co/api/v2/version/7/"
			}
		}]
	}],
	"location_area_encounters": "/api/v2/pokemon/35/encounters",
	"moves": [{
		"move": {
			"name": "pound",
			"url": "https://pokeapi.co/api/v2/move/1/"
		},
		"version_group_details": [{
			"level_learned_at": 1,
			"version_group": {
				"name": "red-blue",
				"url": "https://pokeapi.co/api/v2/version-group/1/"
			},
			"move_learn_method": {
				"name": "level-up",
				"url": "https://pokeapi.co/api/v2/move-learn-method/1/"
			}
		}]
	}],
	"species": {
		"name": "clefairy",
        "url": "https://pokeapi.co/api/v2/pokemon-species/35/"
	},
	"stats": [{
		"base_stat": 35,
		"effort": 0,
		"stat": {
			"name": "speed",
			"url": "https://pokeapi.co/api/v2/stat/6/"
		}
	}],
	"types": [{
		"slot": 1,
		"type": {
			"name": "fairy",
			"url": "https://pokeapi.co/api/v2/type/18/"
		}
	}],
	"past_types": [{
		"generation": {
			"name": "generation-v",
			"url": "https://pokeapi.co/api/v2/generation/5/"
		},
		"types": [
			{
				"slot": 1,
				"type": {
					"name": "normal",
					"url": "https://pokeapi.co/api/v2/type/1/"
				}
			}
		]
	}]
}

response models

Pokemon

Name	Description	Data Type
id	The identifier for this pokémon resource	integer
name	The name for this pokémon resource	string
base_experience	The base experience gained for defeating this pokémon	integer
height	The height of this pokémon	integer
is_default	Set for exactly one pokémon used as the default for each species	boolean
order	Order for sorting. Almost national order, except families are grouped together.	integer
weight	The mass of this pokémon	integer
abilities	A list of abilities this pokémon could potentially have	list PokemonAbility
forms	A list of forms this pokémon can take on	list NamedAPIResource (PokemonForm)
game_indices	A list of game indices relevent to pokémon item by generation	list VersionGameIndex
held_items	A list of items this pokémon may be holding when encountered	list NamedAPIResource (Item)
location_area_encounters	A list of location areas as well as encounter details pertaining to specific versions	list LocationAreaEncounter
moves	A list of moves along with learn methods and level details pertaining to specific version groups	list NamedAPIResource (Move)
species	The species this pokémon belongs to	NamedAPIResource (PokemonSpecies)
stats	A list of base stat values for this pokémon	list NamedAPIResource (Stat)
types	A list of details showing types this pokémon has	list PokemonType
past_types	A list of details showing types this pokémon had in previous generations	list PokemonTypePast

PokemonAbility

Name	Description	Data Type
is_hidden	Whether or not this is a hidden ability	boolean
slot	The slot this ability occupies in this pokémon species	integer
ability	The ability the pokémon may have	NamedAPIResource (Ability)

PokemonType

Name	Description	Data Type
slot	The order the pokémon types are listed in	integer
type	The type the referenced pokémon has	string

PokemonFormType

Name	Description	Data Type
slot	The order the Pokémon form types are listed in	integer
type	The type the referenced Pokémon form has	string

PokemonTypePast

Name	Description	Data Type
generation	The last generation in which the referenced pokémon had the listed types	NamedAPIResource (Generation)
types	The types the referenced pokémon had up to and including the listed generation	list PokemonType

LocationAreaEncounter

Name	Description	Data Type
location_area	The location area the referenced pokémon can be encountered in	APIResource (LocationArea)
version_details	A 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}

example response

{
	"id": 1,
	"name": "black",
	"names": [{
		"name": "é»’ã„",
		"language": {
			"name": "ja",
			"url": "http://pokeapi.co/api/v2/language/1/"
		}
	}],
	"pokemon_species": [{
		"name": "snorlax",
		"url": "http://pokeapi.co/api/v2/pokemon-species/143/"
	}]
}

response models

PokemonColor

Name	Description	Data Type
id	The identifier for this pokémon color resource	integer
name	The name for this pokémon color resource	string
names	The name of this pokémon color listed in different languages	list Name
pokemon_species	A 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}

example response

{
    "id": 10041,
    "name": "arceus-bug",
    "order": 631,
    "form_order": 7,
    "is_default": false,
    "is_battle_only": false,
    "is_mega": false,
    "form_name": "bug",
    "pokemon": {
        "name": "arceus",
        "url": "https://pokeapi.co/api/v2/pokemon/493/"
    },
    "version_group": {
        "name": "diamond-pearl",
        "url": "https://pokeapi.co/api/v2/version-group/8/"
    },
    "types": [
        {
            "slot": 1,
            "type": {
                "name": "bug",
                "url": "https://pokeapi.co/api/v2/type/7/"
            }
        }
    ]
}

response models

PokemonForm

Name	Description	Data Type
id	The identifier for this pokémon form resource	integer
name	The name for this pokémon form resource	string
order	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.	integer
form_order	The order in which forms should be sorted within a species' forms	integer
is_default	True for exactly one form used as the default for each pokémon	boolean
is_battle_only	Whether or not this form can only happen during battle	boolean
is_mega	Whether or not this form requires mega evolution	boolean
form_name	The name of this form	string
pokemon	The pokémon that can take on this form	NamedAPIResource (Pokemon)
version_group	The version group this pokémon form was introduced in	NamedAPIResource (VersionGroup)
types	A list of details showing types this Pokémon form has, if they differ from the types of the Pokémon that can take on this form	list PokemonFormType

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}

example response

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

response models

PokemonHabitat

Name	Description	Data Type
id	The identifier for this pokémon habitat resource	integer
name	The name for this pokémon habitat resource	string
names	The name of this pokémon habitat listed in different languages	list Name
pokemon_species	A 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}

example response

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

response models

PokemonShape

Name	Description	Data Type
id	The identifier for this pokémon shape resource	integer
name	The name for this pokémon shape resource	string
awesome_names	The "scientific" name of this pokémon shape listed in different languages	list AwesomeName
names	The name of this pokémon shape listed in different languages	list Name
pokemon_species	A list of the pokémon species that have this shape	list NamedAPIResource (PokemonSpecies)

AwesomeName

Name	Description	Data Type
awesome_name	The localized "scientific" name for an api resource in a specific language	string
language	The 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}

example response

{
	"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": "http://pokeapi.co/api/v2/growth-rate/2/"
	},
	"pokedex_numbers": [{
		"entry_number": 45,
		"pokedex": {
			"name": "kalos-central",
			"url": "http://pokeapi.co/api/v2/pokedex/12/"
		}
	}],
	"egg_groups": [{
		"name": "bug",
		"url": "http://pokeapi.co/api/v2/egg-group/3/"
	}],
	"color": {
		"name": "gray",
		"url": "http://pokeapi.co/api/v2/pokemon-color/4/"
	},
	"shape": {
		"name": "squiggle",
		"url": "http://pokeapi.co/api/v2/pokemon-shape/2/"
	},
	"evolves_from_species": {
		"name": "burmy",
		"url": "http://pokeapi.co/api/v2/pokemon-species/412/"
	},
	"evolution_chain": {
		"url": "http://pokeapi.co/api/v2/evolution-chain/213/"
	},
	"habitat": null,
	"generation": {
		"name": "generation-iv",
		"url": "http://pokeapi.co/api/v2/generation/4/"
	},
	"names": [{
		"name": "Wormadam",
		"language": {
			"name": "en",
			"url": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"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": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"genera": [{
		"genus": "Bagworm",
		"language": {
			"name": "en",
			"url": "http://pokeapi.co/api/v2/language/9/"
		}
	}],
	"varieties": [{
		"is_default": true,
		"pokemon": {
			"name": "wormadam-plant",
			"url": "http://pokeapi.co/api/v2/pokemon/413/"
		}
	}]
}

response models

PokemonSpecies

Name	Description	Data Type
id	The identifier for this pokémon species resource	integer
name	The name for this pokémon species resource	string
order	The order in which species should be sorted. Based on National Dex order, except families are grouped together and sorted by stage.	integer
gender_rate	The chance of this Pokémon being female, in eighths; or -1 for genderless	integer
capture_rate	The base capture rate; up to 255. The higher the number, the easier the catch.	integer
base_happiness	The happiness when caught by a normal pokéball; up to 255. The higher the number, the happier the pokémon.	integer
is_baby	Whether or not this is a baby pokémon	boolean
hatch_counter	Initial 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_differences	Whether or not this pokémon can have different genders	boolean
forms_switchable	Whether or not this pokémon has multiple forms and can switch between them	boolean
growth_rate	The rate at which this pokémon species gains levels	NamedAPIResource (GrowthRate)
pokedex_numbers	A list of pokedexes and the indexes reserved within them for this pokémon species	list PokemonSpeciesDexEntry
egg_groups	A list of egg groups this pokémon species is a member of	list NamedAPIResource (EggGroup)
color	The color of this pokémon for gimmicky pokedex search	list NamedAPIResource (PokemonColor)
shape	The shape of this pokémon for gimmicky pokedex search	list NamedAPIResource (PokemonShape)
evolves_from_species	The pokémon species that evolves into this pokemon_species	NamedAPIResource (PokemonSpecies)
evolution_chain	The evolution chain this pokémon species is a member of	APIResource (EvolutionChain)
habitat	The habitat this pokémon species can be encountered in	NamedAPIResource (PokemonHabitat)
generation	The generation this pokémon species was introduced in	NamedAPIResource (Generation)
names	The name of this pokémon species listed in different languages	list Name
pal_park_encounters	A list of encounters that can be had with this pokémon species in pal park	list PalParkEncounterArea
form_descriptions	Descriptions of different forms pokémon take on within the pokémon species	list Description
genera	The genus of this pokémon species listed in multiple languages	Genus
varieties	A list of the pokémon that exist within this pokémon species	list NamedAPIResource (Pokemon)

Genus

Name	Description	Data Type
genus	The localized genus for the referenced pokémon species	string
language	The language this genus is in	NamedAPIResource (Language)

PokemonSpeciesDexEntry

Name	Description	Data Type
entry_number	The index number within the pokédex	integer
name	The pokédex the referenced pokémon species can be found in	NamedAPIResource (Pokedex)

PalParkEncounterArea

Name	Description	Data Type
base_score	The base score given to the player when the referenced pokemon is caught during a pal park run	integer
rate	The base rate for encountering the referenced pokemon in this pal park area	integer
area	The pal park area where this encounter happens	NamedAPIResource (PalParkArea)

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 momenarily by effects in battles.

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

example response

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

response models

Stat

Name	Description	Data Type
id	The identifier for this stat resource	integer
name	The name for this stat resource	string
game_index	ID the games use for this stat	integer
is_battle_only	Whether this stat only exists within a battle	boolean
affecting_moves	A detail of moves which affect this stat positively or negatively	MoveStatAffectSets
affecting_natures	A detail of natures which affect this stat positively or negatively	NatureStatAffectSets
characteristics	A list of characteristics that are set on a pokemon when its highest base stat is this stat	list APIResource (Characteristic)
move_damage_class	The class of damage this stat is directly related to	NamedAPIResource (MoveDamageClass)
names	The name of this region listed in different languages	list Name

MoveStatAffectSets

Name	Description	Data Type
increase	A list of moves and how they change the referenced stat	list MoveStatAffect
decrease	A list of moves and how they change the referenced stat	list MoveStatAffect

MoveStatAffect

Name	Description	Data Type
max_change	The maximum amount of change to the referenced stat	integer
move	The move causing the change	NamedAPIResource (Move)

NatureStatAffectSets

Name	Description	Data Type
increase	A list of natures and how they change the referenced stat	list NatureStatAffect
decrease	A list of natures and how they change the referenced stat	list NatureStatAffect

NatureStatAffect

Name	Description	Data Type
max_change	The maximum amount of change to the referenced stat	integer
nature	The nature causing the change	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}

example response

{
    "id": 8,
    "name": "ghost",
    "damage_relations": {
        "no_damage_to": [
            {
                "name": "normal",
                "url": "https://pokeapi.co/api/v2/type/1/"
            }
        ],
        "half_damage_to": [
            {
                "name": "dark",
                "url": "https://pokeapi.co/api/v2/type/17/"
            }
        ],
        "double_damage_to": [
            {
                "name": "ghost",
                "url": "https://pokeapi.co/api/v2/type/8/"
            }
        ],
        "no_damage_from": [
            {
                "name": "normal",
                "url": "https://pokeapi.co/api/v2/type/1/"
            }
        ],
        "half_damage_from": [
            {
                "name": "poison",
                "url": "https://pokeapi.co/api/v2/type/4/"
            }
        ],
        "double_damage_from": [
            {
                "name": "ghost",
                "url": "https://pokeapi.co/api/v2/type/8/"
            }
        ]
    },
    "past_damage_relations": [
        {
            "generation": {
                "name": "generation-v",
                "url": "https://pokeapi.co/api/v2/generation/5/"
            },
            "damage_relations": {
                "no_damage_to": [
                    {
                        "name": "normal",
                        "url": "https://pokeapi.co/api/v2/type/1/"
                    }
                ],
                "half_damage_to": [
                    {
                        "name": "steel",
                        "url": "https://pokeapi.co/api/v2/type/9/"
                    }
                ],
                "double_damage_to": [
                    {
                        "name": "ghost",
                        "url": "https://pokeapi.co/api/v2/type/8/"
                    }
                ],
                "no_damage_from": [
                    {
                        "name": "normal",
                        "url": "https://pokeapi.co/api/v2/type/1/"
                    }
                ],
                "half_damage_from": [
                    {
                        "name": "poison",
                        "url": "https://pokeapi.co/api/v2/type/4/"
                    }
                ],
                "double_damage_from": [
                    {
                        "name": "ghost",
                        "url": "https://pokeapi.co/api/v2/type/8/"
                    }
                ]
            }
        }
    ],
    "game_indices": [
        {
            "game_index": 8,
            "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-Hrkt",
                "url": "https://pokeapi.co/api/v2/language/1/"
            }
        }
    ],
    "pokemon": [
        {
            "slot": 1,
            "pokemon": {
                "name": "gastly",
                "url": "https://pokeapi.co/api/v2/pokemon/92/"
            }
        }
    ],
    "moves": [
        {
            "name": "night-shade",
            "url": "https://pokeapi.co/api/v2/move/101/"
        }
    ]
}

response models

Type

Name	Description	Data Type
id	The identifier for this type resource	integer
name	The name for this type resource	string
damage_relations	A detail of how effective this type is toward others and vice versa	TypeRelations
past_damage_relations	A list of details of how effective this type was toward others and vice versa in previous generations	list TypeRelationsPast
game_indices	A list of game indices relevent to this item by generation	list GenerationGameIndex
generation	The generation this type was introduced in	NamedAPIResource (Generation)
move_damage_class	The class of damage inflicted by this type	NamedAPIResource (MoveDamageClass)
names	The name of this type listed in different languages	list Name
pokemon	A list of details of pokemon that have this type	TypePokemon
moves	A list of moves that have this type	list NamedAPIResource (Move)

TypePokemon

Name	Description	Data Type
slot	The order the pokemons types are listed in	integer
pokemon	The pokemon that has the referenced type	NamedAPIResource (Pokemon)

TypeRelations

Name	Description	Data Type
no_damage_to	A list of types this type has no effect on	list NamedAPIResource (Type)
half_damage_to	A list of types this type is not very effect against	list NamedAPIResource (Type)
double_damage_to	A list of types this type is very effect against	list NamedAPIResource (Type)
no_damage_from	A list of types that have no effect on this type	list NamedAPIResource (Type)
half_damage_from	A list of types that are not very effective against this type	list NamedAPIResource (Type)
double_damage_from	A list of types that are very effective against this type	list NamedAPIResource (Type)

TypeRelationsPast

Name	Description	Data Type
generation	The last generation in which the referenced type had the listed damage relations	NamedAPIResource (Generation)
damage_relations	The damage relations the referenced type had up to and including the listed generation	list TypeRelations

Utility

Languages

Languages for translations of api resource information.

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

example response

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

response models

Language

Name	Description	Data Type
id	The identifier for this language resource	integer
name	The name for this language resource	string
official	Whether or not the games are published in this language	boolean
iso639	The two-letter code of the country where this language is spoken. Note that it is not unique.	string
iso3166	The two-letter code of the language. Note that it is not unique.	string
names	The name of this language listed in different languages	list Name

Common Models

APIResource

Name	Description	Data Type
url	The url of the referenced resource	string

Description

Name	Description	Data Type
description	The localized description for an api resource in a specific language	string
language	The language this description is in	NamedAPIResource (Language)

Effect

Name	Description	Data Type
effect	The localized effect text for an api resource in a specific language	string
language	The language this effect is in	NamedAPIResource (Language)

Encounter

Name	Description	Data Type
min_level	The lowest level the pokemon could be encountered at	integer
max_level	The highest level the pokemon could be encountered at	integer
condition_values	A list of condition values that must be in effect for this encounter to occur	list NamedAPIResource (EncounterConditionValue)
chance	percent chance that this encounter will occur	integer
method	The method by which this encounter happens	NamedAPIResource (EncounterMethod)

FlavorText

Name	Description	Data Type
flavor_text	The localized name for an api resource in a specific language	string
language	The language this flavor text is in	NamedAPIResource (Language)

GenerationGameIndex

Name	Description	Data Type
game_index	The internal id of an api resource within game data	integer
generation	The generation relevent to this game index	NamedAPIResource (Generation)

Name

Name	Description	Data Type
name	The localized name for an api resource in a specific language	string
language	The language this name is in	NamedAPIResource (Language)

NamedAPIResource

Name	Description	Data Type
name	The name of the referenced resource	string
url	The url of the referenced resource	string

VerboseEffect

Name	Description	Data Type
effect	The localized effect text for an api resource in a specific language	string
short_effect	The localized effect text in brief	string
language	The language this effect is in	NamedAPIResource (Language)

VersionEncounterDetail

Name	Description	Data Type
version	The game version this encounter happens in	NamedAPIResource (Version)
max_chance	The total percentage of all encounter potential	integer
encounter_details	A list of encounters and their specifics	list Encounter

VersionGameIndex

Name	Description	Data Type
game_index	The internal id of an api resource within game data	integer
version	The version relevant to this game index	NamedAPIResource (Version)

VersionGroupFlavorText

Name	Description	Data Type
text	The localized name for an api resource in a specific language	string
language	The language this name is in	NamedAPIResource (Language)
version_group	The version group which uses this flavor text	NamedAPIResource (VersionGroup)

README.md Unescape Escape

Pokeapi V2 API Reference

Resource Lists

GET api/v2/{endpoint}

example response for non-named resources

APIResourceList

example response for named resources

NamedAPIResourceList

Berries

Berries

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

example response

response models

Berry

BerryFlavorMap

Berry Firmnesses

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

example response

response models

BerryFirmness

Berry Flavors

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

example response

response models

BerryFlavor

FlavorBerryMap

Contests

Contest Types

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

example response

response models

ContestType

Contest Effects

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

example response

response models

ContestEffect

Super Contest Effects

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

example response

response models

SuperContestEffect

Encounters

Encounter Methods

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

example response

response models

EncounterMethod

Encounter Conditions

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

example response

response models

EncounterCondition

Encounter Condition Values

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

example response

response models

EncounterConditionValue

Evolution

Evolution Chains

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

example response

response models

EvolutionChain

ChainLink

EvolutionDetail

Evolution Triggers

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

example response

response models

EvolutionTrigger

Games

Generations

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

example response

response models

Generation

Pokedexes

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

example response

README.md