## 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
```json
{
"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](#apiresource) |
###### example response for named resources
```json
{
"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](#namedapiresource) |
Berries
## 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](http://bulbapedia.bulbagarden.net/wiki/Berry) for greater detail.
### GET api/v2/berry/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([BerryFirmness](#berry-firmnesses)) |
| 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](#berryflavormap) |
| item | Berries are actually items. This is a reference to the item specific data for this berry. | [NamedAPIResource](#namedapiresource) ([Item](#items)) |
| natural_gift_type | The Type the move "Natural Gift" has when used with this Berry | [NamedAPIResource](#namedapiresource) ([Type](#types)) |
#### BerryFlavorMap
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| potency | How powerful the referenced flavor is for this berry | integer |
| flavor | The referenced berry flavor | [NamedAPIResource](#namedapiresource) ([BerryFlavor](#berry-flavors)) |
## Berry Firmnesses
### GET api/v2/berry-firmness/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Berry](#berries)) |
| names | The name of this berry firmness listed in different languages | list [Name](#resourcename) |
## Berry Flavors
Flavors determine whether a pokemon will benefit or suffer from eating a berry based on their [nature](#natures). Check out [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Flavor) for greater detail.
### GET api/v2/berry-flavor/{id or name}
###### example response
```json
{
"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](#flavorberrymap) |
| contest_type | The contest type that correlates with this berry flavor | [NamedAPIResource](#namedapiresource) ([ContestType](#contest-types)) |
| names | The name of this berry flavor listed in different languages | list [Name](#resourcename) |
#### FlavorBerryMap
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| potency | How powerful the referenced flavor is for this berry | integer |
| berry | The berry with the referenced flavor | [NamedAPIResource](#namedapiresource) ([Berry](#berry)) |
Contests
## Contest Types
Contest types are categories judges used to weigh a pokémon's condition in pokemon contests. Check out [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Contest_condition) for greater detail.
### GET api/v2/contest-type/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([BerryFlavor](#berry-flavors)) |
| names | The name of this contest type listed in different languages | list [Name](#resourcename) |
## Contest Effects
Contest effects refer to the effects of moves when used in contests.
### GET api/v2/contest-effect/{id}
###### example response
```json
{
"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](#effect) |
| flavor_text_entries | The flavor text of this contest effect listed in different languages | list [FlavorText](#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
```json
{
"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](#flavortext) |
| moves | A list of moves that have the effect when used in super contests | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
Encounters
## Encounter Methods
Methods by which the player might can encounter pokémon in the wild, e.g., walking in tall grass. Check out [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Wild_Pokémon) for greater detail.
### GET api/v2/encounter-method/{id or name}
###### example response
```json
{
"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](#resourcename) |
## 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
```json
{
"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](#resourcename) |
| values | A list of possible values for this encounter condition | list [NamedAPIResource](#namedapiresource) ([EncounterConditionValue](#encounter-condition-values)) |
## 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
```json
{
"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](#namedapiresource) ([EncounterCondition](#encounter-conditions)) |
| names | The name of this encounter condition value listed in different languages | list [Name](#resourcename) |
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
```json
{
"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](#namedapiresource) ([Item](#items)) |
| 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) |
#### 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](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
| evolution_details | All details regarding the specific details of the referenced pokémon species evolution | [EvolutionDetail](#evolutiondetail) |
| evolves_to | A List of chain objects. | list [ChainLink](#chainlink) |
#### EvolutionDetail
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| item | The item required to cause evolution this into pokémon species | [NamedAPIResource](#namedapiresource) ([Item](#items)) |
| trigger | The type of event that triggers evolution into this pokémon species | [NamedAPIResource](#namedapiresource) ([EvolutionTrigger](#evolution-triggers)) |
| gender | The gender the evolving pokémon species must be in order to evolve into this pokémon species | [NamedAPIResource](#namedapiresource) ([Gender](#genders)) |
| 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](#namedapiresource) ([Item](#items)) |
| 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](#namedapiresource) ([Move](#moves)) |
| 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](#namedapiresource) ([Type](#types)) |
| location | The location the evolution must be triggered at. | [NamedAPIResource](#namedapiresource) ([Location](#locations)) |
| 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](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
| 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](#namedapiresource) ([Type](#types)) |
| 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](#namedapiresource) ([Pokémon Species](#pokemon-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](http://bulbapedia.bulbagarden.net/wiki/Methods_of_evolution) for greater detail.
### GET api/v2/evolution-trigger/{id or name}
###### example response
```json
{
"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](#resourcename) |
| pokemon_species | A list of pokémon species that result from this evolution trigger | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
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
```json
{
"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](#namedapiresource) ([Ability](#abilities)) |
| names | The name of this generation listed in different languages | list [Name](#resourcename) |
| main_region | The main region travelled in this generation | [NamedAPIResource](#namedapiresource) ([Region](#regions)) |
| moves | A list of moves that were introduced in this generation | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| pokemon_species | A list of pokémon species that were introduced in this generation | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
| types | A list of types that were introduced in this generation | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| version_groups | A list of version groups that were introduced in this generation | list [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
## 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](http://bulbapedia.bulbagarden.net/wiki/Pokedex) 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
```json
{
"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](#description) |
| names | The name of this pokédex listed in different languages | list [Name](#resourcename) |
| pokemon_entries | A list of pokémon catalogued in this pokédex and their indexes | list [PokemonEntry](#pokemonentry) |
| region | The region this pokédex catalogues pokémon for | [NamedAPIResource](#namedapiresource) ([Region](#regions)) |
| version_groups | A list of version groups this pokédex is relevent to | list [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
#### 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](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
## Versions
Versions of the games, e.g., Red, Blue or Yellow.
### GET api/v2/version/{id or name}
###### example response
```json
{
"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](#resourcename) |
| version_group | The version group this version belongs to | [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
## Version Groups
Version groups categorize highly similar versions of the games.
### GET api/v2/version-group/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Generation](#generations)) |
| move_learn_methods | A list of methods in which pokemon can learn moves in this version group | list [NamedAPIResource](#namedapiresource) ([MoveLearnMethod](#move-learn-methods)) |
| names | The name of this version group listed in different languages | list [Name](#resourcename) |
| pokedexes | A list of pokedexes introduces in this version group | list [NamedAPIResource](#namedapiresource) ([Pokedex](#pokedexes)) |
| regions | A list of regions that can be visited in this version group | list [NamedAPIResource](#namedapiresource) ([Region](#regions)) |
| versions | The versions this version group owns | list [NamedAPIResource](#namedapiresource) ([Version](#versions)) |
Items
## 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
```json
{
"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](#item-fling-effects) |
| attributes | A list of attributes this item has | list [NamedAPIResource](#namedapiresource) ([ItemAttribute](#item-attributes)) |
| category | The category of items this item falls into | [ItemCategory](#item-categories) |
| effect_entries | The effect of this ability listed in different languages | list [VerboseEffect](#verboseeffect) |
| flavor_text_entries | The flavor text of this ability listed in different languages | list [VersionGroupFlavorText](#versiongroupflavortext) |
| game_indices | A list of game indices relevent to this item by generation | list [GenerationGameIndex](#generationgameindex) |
| names | The name of this item listed in different languages | list [Name](#resourcename) |
| held_by_pokemon | A list of pokémon that might be found in the wild holding this item | list [HeldByPokemon](#heldbypokemon) |
| baby_trigger_for | An evolution chain this item requires to produce a bay during mating | list [APIResource](#apiresource) ([EvolutionChain](#evolution-chains)) |
#### HeldByPokemon
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| pokemon | The pokemon who might be holding the item | [NamedAPIResource](#namedapiresource) ([Pokemon](#pokemon)) |
| version_details | Details on chance of the pokemon having the item based on version | list [VersionDetails](#helditemversiondetails) |
#### HeldItemVersionDetails
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| rarity | The chance of the pokemon holding the item | integer |
| version | The version the rarity applies | [NamedAPIResource](#namedapiresource) ([Version](#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
```json
{
"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](#namedapiresource) ([Item](#items)) |
| names | The name of this item attribute listed in different languages | list [Name](#resourcename) |
| descriptions | The description of this item attribute listed in different languages | list [Description](#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
```json
{
"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](#namedapiresource) ([Item](#items)) |
| names | The name of this item category listed in different languages | list [Name](#resourcename) |
| pocket | The pocket items in this category would be put in | [NamedAPIResource](#namedapiresource) ([ItemPocket](#item-pockets)) |
## 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
```json
{
"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](#effect) |
| items | A list of items that have this fling effect | list [NamedAPIResource](#namedapiresource) ([Item](#items)) |
## Item Pockets
Pockets within the players bag used for storing items by category.
### GET api/v2/item-pocket/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([ItemCategory](#item-categories)) |
| names | The name of this item pocket listed in different languages | list [Name](#resourcename) |
Moves
## Moves
Moves are the skills of pokémon in battle. In battle, a Pokémon uses one move each turn. Some moves (including those learned by Hidden Machine) can be used outside of battle as well, usually for the purpose of removing obstacles or exploring new areas.
### GET api/v2/move/{id or name}
###### example response
```json
{
"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](http://bulbapedia.bulbagarden.net/wiki/Priority) 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](#contestcombosets) |
| contest_type | The type of appeal this move gives a pokémon when used in a contest | [NamedAPIResource](#namedapiresource) ([ContestType](#contest-types)) |
| contest_effect | The effect the move has when used in a contest | [NamedAPIResource](#namedapiresource) ([ContestEffect](#contest-effects)) |
| damage_class | The type of damage the move inflicts on the target, e.g. physical | [NamedAPIResource](#namedapiresource) ([MoveDamageClass](#move-damage-classes)) |
| effect_entries | The effect of this move listed in different languages | list [VerboseEffect](#verboseeffect) |
| effect_changes | The list of previous effects this move has had across version groups of the games | list [AbilityEffectChange](#abilityeffectchange) |
| generation | The generation in which this move was introduced | [NamedAPIResource](#namedapiresource) ([Generation](#generations)) |
| meta | Meta data about this move | [MoveMetaData](#movemetadata) |
| names | The name of this move listed in different languages | list [Name](#resourcename) |
| past_values | A list of move resource value changes across ersion groups of the game | list [PastMoveStatValues](#pastmovestatvalues) |
| stat_changes | A list of stats this moves effects and how much it effects them | list [MoveStatChange](#movestatchange) |
| super_contest_effect | The effect the move has when used in a super contest | [NamedAPIResource](#namedapiresource) ([ContestEffect](#contest-effects)) |
| target | The type of target that will recieve the effects of the attack | [NamedAPIResource](#namedapiresource) ([MoveTarget](#move-targets)) |
| type | The elemental type of this move | [NamedAPIResource](#namedapiresource) ([Type](#types)) |
#### 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](#contestcombodetail) |
| super | A detail of moves this move can be used before or after, granting additional appeal points in super contests | list [ContestComboDetail](#contestcombodetail) |
#### ContestComboDetail
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| use_before | A list of moves to use before this move | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| use_after | A list of moves to use after this move | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
#### MoveMetaData
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| ailment | The status ailment this move inflicts on its target | [NamedAPIResource](#namedapiresource) ([MoveAilment](#move-ailments)) |
| category | The category of move this move falls under, e.g. damage or ailment | [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| 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](#namedapiresource) ([Stat](#stats)) |
#### 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](#verboseeffect) |
| type | The elemental type of this move | [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| version group | The version group in which these move stat values were in effect | [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
## Move Ailments
Move Ailments are status conditions caused by moves used during battle. See [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/http://bulbapedia.bulbagarden.net/wiki/Status_condition) for greater detail.
### GET api/v2/move-ailment/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Move](#moves)) |
| names | The name of this move ailment listed in different languages | list [Name](#resourcename) |
## Move Battle Styles
Styles of moves when used in the Battle Palace. See [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Battle_Frontier_(Generation_III)) for greater detail.
### GET api/v2/move-battle-style/{id or name}
###### example response
```json
{
"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](#resourcename) |
## Move Categories
Very general categories that loosely group move effects.
### GET api/v2/move-category/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Move](#moves)) |
| descriptions | The description of this move ailment listed in different languages | list [Description](#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
```json
{
"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](#description) |
| moves | A list of moves that fall into this damage class | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| names | The name of this move damage class listed in different languages | list [Name](#resourcename) |
## Move Learn Methods
Methods by which pokémon can learn moves.
### GET api/v2/move-learn-method/{id or name}
###### example response
```json
{
"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](#description) |
| names | The name of this move learn method listed in different languages | list [Name](#resourcename) |
| version_groups | A list of version groups where moves can be learned through this method | list [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
## 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
```json
{
"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](#description) |
| moves | A list of moves that that are directed at this target | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| names | The name of this move target listed in different languages | list [Name](#resourcename) |
Locations
## Locations
Locations that can be visited within the games. Locations make up sizable portions of regions, like cities or routes.
### GET api/v2/location/{id}
###### example response
```json
{
"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](#namedapiresource) ([Region](#regions)) |
| names | The name of this language listed in different languages | list [Name](#resourcename) |
| game_indices | A list of game indices relevent to this location by generation | list [GenerationGameIndex](#generationgameindex) |
| areas | Areas that can be found within this location | [APIResource](#apiresource) ([LocationArea](#location-areas)) |
## 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
```json
{
"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](#encountermethodrate) |
| location | The region this location can be found in | [NamedAPIResource](#namedapiresource) ([Region](#regions)) |
| names | The name of this location area listed in different languages | list [Name](#resourcename) |
| pokemon_encounters | A list of pokémon that can be encountered in this area along with version specific details about the encounter | list [PokemonEncounter](#pokemonencounter) |
#### EncounterMethodRate
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| encounter_method | The method in which pokémon may be encountered in an area. | [EncounterMethod](#encountermehtod) |
| version_details | The chance of the encounter to occur on a version of the game. | list [EncounterVersionDetails](#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](#namedapiresource) ([Version](#version)) |
#### PokemonEncounter
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| pokemon | The pokémon being encountered | [NamedAPIResource](#namedapiresource) ([Pokemon](#pokemon)) |
| version_details | A list of versions and encounters with pokémon that might happen in the referenced location area | list [VersionEncounterDetail](#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
```json
{
"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](#resourcename) |
| pokemon_encounters | A list of pokémon encountered in thi pal park area along with details | list [PalParkEncounterSpecies](#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](#namedapiresource) ([PokemonSpecies](#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
```json
{
"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](#namedapiresource) ([Location](#locations)) |
| main_generation | The generation this region was introduced in | [NamedAPIResource](#namedapiresource) ([Generation](#generations)) |
| names | The name of this region listed in different languages | list [Name](#resourcename) |
| pokedexes | A list of pokédexes that catalogue pokemon in this region | list [NamedAPIResource](#namedapiresource) ([Pokedex](#pokedexes)) |
| version_groups | A list of version groups where this region can be visited | list [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
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](http://bulbapedia.bulbagarden.net/wiki/Ability) for greater detail.
### GET api/v2/ability/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Generation](#generations)) |
| names | The name of this ability listed in different languages | list [Name](#resourcename) |
| effect_entries | The effect of this ability listed in different languages | list [VerboseEffect](#verboseeffect) |
| effect_changes | The list of previous effects this ability has had across version groups | list [AbilityEffectChange](#abilityeffectchange) |
| flavor_text_entries | The flavor text of this ability listed in different languages | list [VersionGroupFlavorText](#versiongroupflavortext) |
| pokemon | A list of pokémon that could potentially have this ability | list [AbilityPokemon](#abilitypokemon) |
#### AbilityEffectChange
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| effect_entries | The previous effect of this ability listed in different languages | [Effect](#effect) |
| version_group | The version group in which the previous effect of this ability originated | [NamedAPIResource](#namedapiresource) ([VersionGroup](#versiongroups)) |
#### 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](#namedapiresource) ([Language](#languages)) |
| version_group | The version group that uses this flavor text | [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
#### 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](#namedapiresource) ([Pokemon](#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](http://bulbapedia.bulbagarden.net/wiki/Characteristic) for greater detail.
### GET api/v2/characteristic/{id}
###### example response
```json
{
"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](#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](http://bulbapedia.bulbagarden.net/wiki/Egg_Group) for greater detail.
### GET api/v2/egg-group/{id or name}
###### example response
```json
{
"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](#resourcename) |
| pokemon_species | A list of all pokémon species that are members of this egg group | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
## Genders
Genders were introduced in Generation II for the purposes of breeding pokémon but can also rsult in visual differences or even different evolutionary lines. Check out [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Gender) for greater detail.
### GET api/v2/gender/{id or name}
###### example response
```json
{
"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](#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](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
#### 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](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
## Growth Rates
Growth rates are the speed with which pokémon gain levels through experience. Check out [Bulbapedia](http://bulbapedia.bulbagarden.net/wiki/Experience) for greater detail.
### GET api/v2/growth-rate/{id or name}
###### example response
```json
{
"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](#description) |
| levels | A list of levels and the amount of experienced needed to atain them based on this growth rate | list [GrowthRateExperienceLevel](#growthrateexperiencelevel) |
| pokemon_species | A list of pokémon species that gain levels at this growth rate | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
#### 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](http://bulbapedia.bulbagarden.net/wiki/Nature) for greater detail.
### GET api/v2/nature/{id or name}
###### example response
```json
{
"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](#namedapiresource) ([Stat](#stats)) |
| increased_stat | The stat increased by 10% in pokémon with this nature | [NamedAPIResource](#namedapiresource) ([Stat](#stats)) |
| hates_flavor | The flavor hated by pokémon with this nature | [NamedAPIResource](#namedapiresource) ([BerryFlavor](#berry-flavors)) |
| likes_flavor | The flavor liked by pokémon with this nature | [NamedAPIResource](#namedapiresource) ([BerryFlavor](#berry-flavors)) |
| pokeathlon_stat_changes | A list of pokéathlon stats this nature effects and how much it effects them | list [NatureStatChange](#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](#movebattlestylepreference) |
| names | The name of this nature listed in different languages | list [Name](#resourcename) |
#### NatureStatChange
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| change | The amount of change | integer |
| stat | The stat being affected | [NamedAPIResource](#namedapiresource) ([PokeathlonStat](#pokeathlon-stats)) |
#### 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](#namedapiresource) ([MoveBattleStyle](#move-battle-styles)) |
## 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](http://bulbapedia.bulbagarden.net/wiki/Pokéathlon) for greater detail.
### GET api/v2/pokeathlon-stat/{id or name}
###### example response
```json
{
"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](#resourcename) |
| affecting_natures | A detail of natures which affect this pokéathlon stat positively or negatively | [NaturePokeathlonStatAffectSets](#naturepokeathlonstataffectsets) |
#### NaturePokeathlonStatAffectSets
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| increase | A list of natures and how they change the referenced pokéathlon stat | list [NaturePokeathlonStatAffect](#naturepokeathlonstataffect) |
| decrease | A list of natures and how they change the referenced pokéathlon stat | list [NaturePokeathlonStatAffect](#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](#namedapiresource) ([Nature](#natures)) |
## 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](http://bulbapedia.bulbagarden.net/wiki/Pokémon_(species)) for greater detail.
### GET api/v2/pokemon/{id or name}
###### example response
```json
{
"id": 12,
"name": "butterfree",
"base_experience": 178,
"height": 11,
"is_default": true,
"order": 16,
"weight": 320,
"abilities": [{
"is_hidden": true,
"slot": 3,
"ability": {
"name": "tinted-lens",
"url": "http://pokeapi.co/api/v2/ability/110/"
}
}],
"forms": [{
"name": "butterfree",
"url": "http://pokeapi.co/api/v2/pokemon-form/12/"
}],
"game_indices": [{
"game_index": 12,
"version": {
"name": "white-2",
"url": "http://pokeapi.co/api/v2/version/22/"
}
}],
"held_items": [{
"item": {
"name": "silver-powder",
"url": "http://pokeapi.co/api/v2/item/199/"
},
"version_details": [{
"rarity": 5,
"version": {
"name": "y",
"url": "http://pokeapi.co/api/v2/version/24/"
}
}]
}],
"location_area_encounters": [{
"location_area": {
"name": "kanto-route-2-south-towards-viridian-city",
"url": "http://pokeapi.co/api/v2/location-area/296/"
},
"version_details": [{
"max_chance": 10,
"encounter_details": [{
"min_level": 7,
"max_level": 7,
"condition_values": [{
"name": "time-morning",
"url": "http://pokeapi.co/api/v2/encounter-condition-value/3/"
}],
"chance": 5,
"method": {
"name": "walk",
"url": "http://pokeapi.co/api/v2/encounter-method/1/"
}
}],
"version": {
"name": "heartgold",
"url": "http://pokeapi.co/api/v2/version/15/"
}
}]
}],
"moves": [{
"move": {
"name": "flash",
"url": "http://pokeapi.co/api/v2/move/148/"
},
"version_group_details": [{
"level_learned_at": 0,
"version_group": {
"name": "x-y",
"url": "http://pokeapi.co/api/v2/version-group/15/"
},
"move_learn_method": {
"name": "machine",
"url": "http://pokeapi.co/api/v2/move-learn-method/4/"
}
}]
}],
"species": {
"name": "butterfree",
"url": "http://pokeapi.co/api/v2/pokemon-species/12/"
},
"stats": [{
"base_stat": 70,
"effort": 0,
"stat": {
"name": "speed",
"url": "http://pokeapi.co/api/v2/stat/6/"
}
}],
"types": [{
"slot": 2,
"type": {
"name": "flying",
"url": "http://pokeapi.co/api/v2/type/3/"
}
}]
}
```
###### 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](#pokemonability) |
| forms | A list of forms this pokémon can take on | list [NamedAPIResource](#namedapiresource) ([PokemonForm](#pokemon-forms)) |
| game_indices | A list of game indices relevent to pokémon item by generation | list [VersionGameIndex](#versiongameindex) |
| held_items | A list of items this pokémon may be holding when encountered | list [NamedAPIResource](#namedapiresource) ([Item](#items)) |
| location_area_encounters | A list of location areas as well as encounter details pertaining to specific versions | list [LocationAreaEncounter](#locationareaencounter) |
| moves | A list of moves along with learn methods and level details pertaining to specific version groups | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
| species | The species this pokémon belongs to | [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
| stats | A list of base stat values for this pokémon | list [NamedAPIResource](#namedapiresource) ([Stat](#stats)) |
| types | A list of details showing types this pokémon has | list [PokemonType](#pokemontype) |
#### 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](#namedapiresource) ([Ability](#abilities)) |
#### 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 |
#### LocationAreaEncounter
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| location_area | The location area the referenced pokémon can be encountered in | [APIResource](#apiresource) ([LocationArea](#location-areas)) |
| version_details | A list of versions and encounters with the referenced pokémon that might happen | list [VersionEncounterDetail](#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
```json
{
"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](#resourcename) |
| pokemon_species | A list of the pokémon species that have this color | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
## 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
```json
{
"id": 413,
"name": "wormadam-plant",
"order": 503,
"form_order": 1,
"is_default": true,
"is_battle_only": false,
"is_mega": false,
"form_name": "plant",
"pokemon": {
"name": "wormadam-plant",
"url": "http://pokeapi.co/api/v2/pokemon/413/"
},
"version_group": {
"name": "diamond-pearl",
"url": "http://pokeapi.co/api/v2/version-group/8/"
}
}
```
###### 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](#namedapiresource) ([Pokemon](#pokemon)) |
| version_group | The version group this pokémon form was introduced in | [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |
## 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
```json
{
"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](#resourcename) |
| pokemon_species | A list of the pokémon species that can be found in this habitat | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
## Pokémon Shapes
Shapes used for sorting pokémon in a pokédex.
### GET api/v2/pokemon-shape/{id or name}
###### example response
```json
{
"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](#awesomename) |
| names | The name of this pokémon shape listed in different languages | list [Name](#resourcename) |
| pokemon_species | A list of the pokémon species that have this shape | list [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
#### 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](#namedapiresource) ([Language](#languages)) |
## 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
```json
{
"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](#namedapiresource) ([GrowthRate](#growth-rates)) |
| pokedex_numbers | A list of pokedexes and the indexes reserved within them for this pokémon species | list [PokemonSpeciesDexEntry](#pokemonspeciesdexentry) |
| egg_groups | A list of egg groups this pokémon species is a member of | list [NamedAPIResource](#namedapiresource) ([EggGroup](#egg-groups)) |
| color | The color of this pokémon for gimmicky pokedex search | list [NamedAPIResource](#namedapiresource) ([PokemonColor](#pokemon-colors)) |
| shape | The shape of this pokémon for gimmicky pokedex search | list [NamedAPIResource](#namedapiresource) ([PokemonShape](#pokemon-shapes)) |
| evolves_from_species | The pokémon species that evolves into this pokemon_species | [NamedAPIResource](#namedapiresource) ([PokemonSpecies](#pokemon-species)) |
| evolution_chain | The evolution chain this pokémon species is a member of | [APIResource](#apiresource) ([EvolutionChain](#evolution-chains)) |
| habitat | The habitat this pokémon species can be encountered in | [NamedAPIResource](#namedapiresource) ([PokemonHabitat](#pokemon-habitats)) |
| generation | The generation this pokémon species was introduced in | [NamedAPIResource](#namedapiresource) ([Generation](#generations)) |
| names | The name of this pokémon species listed in different languages | list [Name](#resourcename) |
| pal_park_encounters | A list of encounters that can be had with this pokémon species in pal park | list [PalParkEncounterArea](#palparkencounterarea) |
| form_descriptions | Descriptions of different forms pokémon take on within the pokémon species | list [Description](#description) |
| genera | The genus of this pokémon species listed in multiple languages | [Genus](#genus) |
| varieties | A list of the pokémon that exist within this pokémon species | list [NamedAPIResource](#namedapiresource) ([Pokemon](#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](#namedapiresource) ([Language](#languages)) |
#### 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](#namedapiresource) ([Pokedex](#pokedexes)) |
#### 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](#namedapiresource) ([PalParkArea](#pal-park-areas)) |
## 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
```json
{
"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](#movestataffectsets) |
| affecting_natures | A detail of natures which affect this stat positively or negatively | [NatureStatAffectSets](#naturestataffectsets) |
| characteristics | A list of characteristics that are set on a pokemon when its highest base stat is this stat | list [APIResource](#apiresource) ([Characteristic](#characteristics)) |
| move_damage_class | The class of damage this stat is directly related to | [NamedAPIResource](#namedapiresource) ([MoveDamageClass](#move-damage-classes)) |
| names | The name of this region listed in different languages | list [Name](#resourcename) |
#### MoveStatAffectSets
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| increase | A list of moves and how they change the referenced stat | list [MoveStatAffect](#movestataffect) |
| decrease | A list of moves and how they change the referenced stat | list [MoveStatAffect](#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](#namedapiresource) ([Move](#moves)) |
#### NatureStatAffectSets
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| increase | A list of natures and how they change the referenced stat | list [NatureStatAffect](#naturestataffect) |
| decrease | A list of natures and how they change the referenced stat | list [NatureStatAffect](#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](#namedapiresource) ([Nature](#natures)) |
## 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
```json
{
"id": 5,
"name": "ground",
"damage_relations": {
"no_damage_to": [{
"name": "flying",
"url": "http://pokeapi.co/api/v2/type/3/"
}],
"half_damage_to": [{
"name": "bug",
"url": "http://pokeapi.co/api/v2/type/7/"
}],
"double_damage_to": [{
"name": "poison",
"url": "http://pokeapi.co/api/v2/type/4/"
}],
"no_damage_from": [{
"name": "electric",
"url": "http://pokeapi.co/api/v2/type/13/"
}],
"half_damage_from": [{
"name": "poison",
"url": "http://pokeapi.co/api/v2/type/4/"
}],
"double_damage_from": [{
"name": "water",
"url": "http://pokeapi.co/api/v2/type/11/"
}]
},
"game_indices": [{
"game_index": 4,
"generation": {
"name": "generation-i",
"url": "http://pokeapi.co/api/v2/generation/1/"
}
}],
"generation": {
"name": "generation-i",
"url": "http://pokeapi.co/api/v2/generation/1/"
},
"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/"
}
}],
"pokemon": [{
"slot": 1,
"pokemon": {
"name": "sandshrew",
"url": "http://pokeapi.co/api/v2/pokemon/27/"
}
}],
"moves": [{
"name": "sand-attack",
"url": "http://pokeapi.co/api/v2/move/28/"
}]
}
```
###### 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](#typerelations) |
| game_indices | A list of game indices relevent to this item by generation | list [GenerationGameIndex](#generationgameindex) |
| generation | The generation this type was introduced in | [NamedAPIResource](#namedapiresource) ([Generation](#generations)) |
| move_damage_class | The class of damage inflicted by this type | [NamedAPIResource](#namedapiresource) ([MoveDamageClass](#move-damage-classes)) |
| names | The name of this type listed in different languages | list [Name](#resourcename) |
| pokemon | A list of details of pokemon that have this type | [TypePokemon](#typepokemon) |
| moves | A list of moves that have this type | list [NamedAPIResource](#namedapiresource) ([Move](#moves)) |
#### TypePokemon
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| slot | The order the pokemons types are listed in | integer |
| pokemon | The pokemon that has the referenced type | [NamedAPIResource](#namedapiresource) ([Pokemon](#pokemon)) |
#### TypeRelations
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| no_damage_to | A list of types this type has no effect on | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| half_damage_to | A list of types this type is not very effect against | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| double_damage_to | A list of types this type is very effect against | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| no_damage_from | A list of types that have no effect on this type | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| half_damage_from | A list of types that are not very effective against this type | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
| double_damage_from | A list of types that are very effective against this type | list [NamedAPIResource](#namedapiresource) ([Type](#types)) |
Utility
## Languages
Languages for translations of api resource information.
### GET api/v2/language/{id or name}
###### example response
```json
{
"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](#resourcename) |
## 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](#namedapiresource) ([Language](#languages)) |
#### 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](#namedapiresource) ([Language](#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](#namedapiresource) ([EncounterConditionValue](#encounter-condition-values)) |
| chance | percent chance that this encounter will occur | integer |
| method | The method by which this encounter happens | [NamedAPIResource](#namedapiresource) ([EncounterMethod](#encounter-methods)) |
#### 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](#namedapiresource) ([Language](#languages)) |
#### 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](#namedapiresource) ([Generation](#generations)) |
#### 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](#namedapiresource) ([Language](#languages)) |
#### 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](#namedapiresource) ([Language](#languages)) |
#### VersionEncounterDetail
| Name | Description | Data Type |
| ---- | ----------- | --------- |
| version | The game version this encounter happens in | [NamedAPIResource](#namedapiresource) ([Version](#versions)) |
| max_chance | The total percentage of all encounter potential | integer |
| encounter_details | A list of encounters and their specifics | list [Encounter](#encounters) |
#### 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](#namedapiresource) ([Version](#versions)) |
#### 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](#namedapiresource) ([Language](#languages)) |
| version_group | The version group which uses this flavor text | [NamedAPIResource](#namedapiresource) ([VersionGroup](#version-groups)) |