Information

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

No authentication is required to access this API, and all resources are fully open and available. Since the move to static hosting in November 2018, rate limiting has been changed to a fixed limit of100 API requests per IP address per minute (this does not include downloading image assets like sprites, which are hosted elsewhere).

If you are going to be regularly using the API, we recommend caching data on your service or deploying your own instance of the API (jump on Slack for help with this).

Fair Use Policy

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

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

Rules:

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

Slack

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

Wrapper Libraries

Resource Lists and Pagination

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

Un-named

GET /api/v2/{endpoint}/

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

APIResourceList

NameDescriptionType
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

A list of un-named API resources.

list APIResource

Named

GET /api/v2/{endpoint}/

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

NamedAPIResourceList

NameDescriptionType
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

A list of named API resources.

list NamedAPIResource

Berries

Berries

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

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

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

Berry

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
growth_time

Time it takes the tree to grow one stage, in hours. Berry trees go through four of these growth stages before they can be picked.

integer
max_harvest

The maximum number of these berries that can grow on one tree in Generation IV.

integer
natural_gift_power

The power of the move "Natural Gift" when used with this Berry.

integer
size

The size of this Berry, in millimeters.

integer
smoothness

The smoothness of this Berry, used in making Pokéblocks or Poffins.

integer
soil_dryness

The speed at which this Berry dries out the soil as it grows. A higher rate means the soil dries more quickly.

integer
firmness

The firmness of this berry, used in making Pokéblocks or Poffins.

NamedAPIResource (BerryFirmness)
flavors

A list of references to each flavor a berry can have and the potency of each of those flavors in regard to this berry.

list BerryFlavorMap
item

Berries are actually items. This is a reference to the item specific data for this berry.

NamedAPIResource (Item)
natural_gift_type

The type inherited by "Natural Gift" when used with this Berry.

NamedAPIResource (Type)

BerryFlavorMap

NameDescriptionType
potency

How powerful the referenced flavor is for this berry.

integer
flavor

The referenced berry flavor.

NamedAPIResource (BerryFlavor)

Berry Firmnesses

Berries can be soft or hard. Check out Bulbapedia for greater detail.

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

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

BerryFirmness

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
berries

A list of the berries with this firmness.

list NamedAPIResource (Berry)
names

The name of this resource listed in different languages.

list Name

Berry Flavors

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

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

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

BerryFlavor

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
berries

A list of the berries with this flavor.

list FlavorBerryMap
contest_type

The contest type that correlates with this berry flavor.

NamedAPIResource (ContestType)
names

The name of this resource listed in different languages.

list Name

FlavorBerryMap

NameDescriptionType
potency

How powerful the referenced flavor is for this berry.

integer
berry

The berry with the referenced flavor.

NamedAPIResource (Berry)

Contests

Contest Types

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

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

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

ContestType

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
berry_flavor

The berry flavor that correlates with this contest type.

NamedAPIResource (BerryFlavor)
names

The name of this contest type listed in different languages.

list ContestName

ContestName

NameDescriptionType
name

The name for this contest.

string
color

The color associated with this contest's name.

string
language

The language that this name is in.

NamedAPIResource (Language)

Contest Effects

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

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

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

ContestEffect

NameDescriptionType
id

The identifier for this resource.

integer
appeal

The base number of hearts the user of this move gets.

integer
jam

The base number of hearts the user's opponent loses.

integer
effect_entries

The result of this contest effect listed in different languages.

list Effect
flavor_text_entries

The flavor text of this contest effect listed in different languages.

list FlavorText

Super Contest Effects

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

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

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

SuperContestEffect

NameDescriptionType
id

The identifier for this resource.

integer
appeal

The level of appeal this super contest effect has.

integer
flavor_text_entries

The flavor text of this super contest effect listed in different languages.

list FlavorText
moves

A list of moves that have the effect when used in super contests.

list NamedAPIResource (Move)

Encounters

Encounter Methods

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

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

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

EncounterMethod

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
order

A good value for sorting.

integer
names

The name of this resource listed in different languages.

list Name

Encounter Conditions

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

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

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

EncounterCondition

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
values

A list of possible values for this encounter condition.

list NamedAPIResource (EncounterConditionValue)

Encounter Condition Values

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

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

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

EncounterConditionValue

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
condition

The condition this encounter condition value pertains to.

list NamedAPIResource (EncounterCondition)
names

The name of this resource listed in different languages.

list Name

Evolution

Evolution Chains

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

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

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

EvolutionChain

NameDescriptionType
id

The identifier for this resource.

integer
baby_trigger_item

The item that a Pokémon would be holding when mating that would trigger the egg hatching a baby Pokémon rather than a basic Pokémon.

NamedAPIResource (Item)
chain

The base chain link object. Each link contains evolution details for a Pokémon in the chain. Each link references the next Pokémon in the natural evolution order.

ChainLink
NameDescriptionType
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 Pokémon species at this point in the evolution chain.

NamedAPIResource (PokemonSpecies)
evolution_details

All details regarding the specific details of the referenced Pokémon species evolution.

list EvolutionDetail
evolves_to

A List of chain objects.

list ChainLink

EvolutionDetail

NameDescriptionType
item

The item required to cause evolution this into Pokémon species.

NamedAPIResource (Item)
trigger

The type of event that triggers evolution into this Pokémon species.

NamedAPIResource (EvolutionTrigger)
gender

The id of the gender of the evolving Pokémon species must be in order to evolve into this Pokémon species.

integer
held_item

The item the evolving Pokémon species must be holding during the evolution trigger event to evolve into this Pokémon species.

NamedAPIResource (Item)
known_move

The move that must be known by the evolving Pokémon species during the evolution trigger event in order to evolve into this Pokémon species.

NamedAPIResource (Move)
known_move_type

The evolving Pokémon species must know a move with this type during the evolution trigger event in order to evolve into this Pokémon species.

NamedAPIResource (Type)
location

The location the evolution must be triggered at.

NamedAPIResource (Location)
min_level

The minimum required level of the evolving Pokémon species to evolve into this Pokémon species.

integer
min_happiness

The minimum required level of happiness the evolving Pokémon species to evolve into this Pokémon species.

integer
min_beauty

The minimum required level of beauty the evolving Pokémon species to evolve into this Pokémon species.

integer
min_affection

The minimum required level of affection the evolving Pokémon species to evolve into this Pokémon species.

integer
needs_overworld_rain

Whether or not it must be raining in the overworld to cause evolution this Pokémon species.

boolean
party_species

The Pokémon species that must be in the players party in order for the evolving Pokémon species to evolve into this Pokémon species.

NamedAPIResource (PokemonSpecies)
party_type

The player must have a Pokémon of this type in their party during the evolution trigger event in order for the evolving Pokémon species to evolve into this Pokémon species.

NamedAPIResource (Type)
relative_physical_stats

The required relation between the Pokémon's Attack and Defense stats. 1 means Attack > Defense. 0 means Attack = Defense. -1 means Attack < Defense.

integer
time_of_day

The required time of day. Day or night.

string
trade_species

Pokémon species for which this one must be traded.

NamedAPIResource (PokemonSpecies)
turn_upside_down

Whether or not the 3DS needs to be turned upside-down as this Pokémon levels up.

boolean

Evolution Triggers

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

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

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

EvolutionTrigger

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
pokemon_species

A list of pokemon species that result from this evolution trigger.

list NamedAPIResource (PokemonSpecies)

Games

Generations

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

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

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

Generation

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
abilities

A list of abilities that were introduced in this generation.

list NamedAPIResource (Ability)
names

The name of this resource listed in different languages.

list Name
main_region

The main region travelled in this generation.

NamedAPIResource (Region)
moves

A list of moves that were introduced in this generation.

list NamedAPIResource (Move)
pokemon_species

A list of Pokémon species that were introduced in this generation.

list NamedAPIResource (PokemonSpecies)
types

A list of types that were introduced in this generation.

list NamedAPIResource (Type)
version_groups

A list of version groups that were introduced in this generation.

list NamedAPIResource (VersionGroup)

Pokedexes

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

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

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

Pokedex

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this 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 resource listed in different languages.

list Description
names

The name of this resource listed in different languages.

list Name
pokemon_entries

A list of Pokémon catalogued in this Pokédex and their indexes.

list PokemonEntry
region

The region this Pokédex catalogues Pokémon for.

NamedAPIResource (Region)
version_groups

A list of version groups this Pokédex is relevant to.

list NamedAPIResource (VersionGroup)

PokemonEntry

NameDescriptionType
entry_number

The index of this Pokémon species entry within the Pokédex.

integer
pokemon_species

The Pokémon species being encountered.

NamedAPIResource (PokemonSpecies)

Version

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

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

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

Version

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
version_group

The version group this version belongs to.

NamedAPIResource (VersionGroup)

Version Groups

Version groups categorize highly similar versions of the games.

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

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

VersionGroup

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this 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.

NamedAPIResource (Generation)
move_learn_methods

A list of methods in which Pokémon can learn moves in this version group.

list NamedAPIResource (MoveLearnMethod)
pokedexes

A list of Pokédexes introduces in this version group.

list NamedAPIResource (Pokedex)
regions

A list of regions that can be visited in this version group.

list NamedAPIResource (Region)
versions

The versions this version group owns.

list NamedAPIResource (Version)

Items

Item

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

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

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

Item

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this 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.

NamedAPIResource (ItemFlingEffect)
attributes

A list of attributes this item has.

list NamedAPIResource (ItemAttribute)
category

The category of items this item falls into.

ItemCategory
effect_entries

The effect of this ability listed in different languages.

list VerboseEffect
flavor_text_entries

The flavor text of this ability listed in different languages.

list VersionGroupFlavorText
game_indices

A list of game indices relevent to this item by generation.

list GenerationGameIndex
names

The name of this item listed in different languages.

list Name
sprites

A set of sprites used to depict this item in the game.

ItemSprites
held_by_pokemon

A list of Pokémon that might be found in the wild holding this item.

list ItemHolderPokemon
baby_trigger_for

An evolution chain this item requires to produce a bay during mating.

APIResource (EvolutionChain)
machines

A list of the machines related to this item.

list MachineVersionDetail

ItemSprites

NameDescriptionType
default

The default depiction of this item.

string

ItemHolderPokemon

NameDescriptionType
pokemon

The Pokémon that holds this item.

string
version_details

The details for the version that this item is held in by the Pokémon.

list ItemHolderPokemonVersionDetail

ItemHolderPokemonVersionDetail

NameDescriptionType
rarity

How often this Pokémon holds this item in this version.

string
version

The version that this item is held in by the Pokémon.

NamedAPIResource (Version)

Item Attributes

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

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

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

ItemAttribute

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
items

A list of items that have this attribute.

list NamedAPIResource (Item)
names

The name of this item attribute listed in different languages.

list Name
descriptions

The description of this item attribute listed in different languages.

list Description

Item Categories

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

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

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

ItemCategory

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
items

A list of items that are a part of this category.

list NamedAPIResource (Item)
names

The name of this item category listed in different languages.

list Name
pocket

The pocket items in this category would be put in.

NamedAPIResource (ItemPocket)

Item Fling Effects

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

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

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

ItemFlingEffect

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
effect_entries

The result of this fling effect listed in different languages.

list Effect
items

A list of items that have this fling effect.

NamedAPIResource (Item)

Item Pockets

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

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

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

ItemPocket

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
categories

A list of item categories that are relevant to this item pocket.

list NamedAPIResource (ItemCategory)
names

The name of this resource listed in different languages.

list Name

Locations

Locations

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

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

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

Location

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
region

The region this location can be found in.

NamedAPIResource (Region)
names

The name of this resource listed in different languages.

list Name
game_indices

A list of game indices relevent to this location by generation.

list GenerationGameIndex
areas

Areas that can be found within this location.

list NamedAPIResource (LocationArea)

Location Areas

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

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

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

LocationArea

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
game_index

The internal id of an API resource within game data.

integer
encounter_method_rates

A list of methods in which Pokémon may be encountered in this area and how likely the method will occur depending on the version of the game.

list EncounterMethodRate
location

The region this location area can be found in.

NamedAPIResource (Location)
names

The name of this resource listed in different languages.

list Name
pokemon_encounters

A list of Pokémon that can be encountered in this area along with version specific details about the encounter.

list PokemonEncounter

EncounterMethodRate

NameDescriptionType
encounter_method

The method in which Pokémon may be encountered in an area..

NamedAPIResource (EncounterMethod)
version_details

The chance of the encounter to occur on a version of the game.

list EncounterVersionDetails

EncounterVersionDetails

NameDescriptionType
rate

The chance of an encounter to occur.

integer
version

The version of the game in which the encounter can occur with the given chance.

NamedAPIResource (Version)

PokemonEncounter

NameDescriptionType
pokemon

The Pokémon being encountered.

NamedAPIResource (Pokemon)
version_details

A list of versions and encounters with Pokémon that might happen in the referenced location area.

list VersionEncounterDetail

Pal Park Areas

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

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

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

PalParkArea

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
pokemon_encounters

A list of Pokémon encountered in thi pal park area along with details.

list PalParkEncounterSpecies

PalParkEncounterSpecies

NameDescriptionType
base_score

The base score given to the player when this Pokémon is caught during a pal park run.

integer
rate

The base rate for encountering this Pokémon in this pal park area.

integer
pokemon_species

The Pokémon species being encountered.

NamedAPIResource (PokemonSpecies)

Regions

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

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

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

Region

NameDescriptionType
id

The identifier for this resource.

integer
locations

A list of locations that can be found in this region.

list NamedAPIResource (Location)
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
main_generation

The generation this region was introduced in.

NamedAPIResource (Generation)
pokedexes

A list of pokédexes that catalogue Pokémon in this region.

list NamedAPIResource (Pokedex)
version_groups

A list of version groups where this region can be visited.

list NamedAPIResource (VersionGroup)

Machines

Machines

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

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

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

Machine

NameDescriptionType
id

The identifier for this resource.

integer
item

The TM or HM item that corresponds to this machine.

NamedAPIResource (Item)
move

The move that is taught by this machine.

NamedAPIResource (Move)
version_group

The version group that this machine applies to.

NamedAPIResource (VersionGroup)

Moves

Moves

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

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

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

Move

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
accuracy

The percent value of how likely this move is to be successful.

integer
effect_chance

The percent value of how likely it is this moves effect will happen.

integer
pp

Power points. The number of times this move can be used.

integer
priority

A value between -8 and 8. Sets the order in which moves are executed during battle. See Bulbapedia for greater detail.

integer
power

The base power of this move with a value of 0 if it does not have a base power.

integer
contest_combos

A detail of normal and super contest combos that require this move.

ContestComboSets
contest_type

The type of appeal this move gives a Pokémon when used in a contest.

NamedAPIResource (ContestType)
contest_effect

The effect the move has when used in a contest.

APIResource (ContestEffect)
damage_class

The type of damage the move inflicts on the target, e.g. physical.

NamedAPIResource (MoveDamageClass)
effect_entries

The effect of this move listed in different languages.

list VerboseEffect
effect_changes

The list of previous effects this move has had across version groups of the games.

list AbilityEffectChange
flavor_text_entries

The flavor text of this move listed in different languages.

list MoveFlavorText
generation

The generation in which this move was introduced.

NamedAPIResource (Generation)
machines

A list of the machines that teach this move.

list MachineVersionDetail
meta

Metadata about this move

MoveMetaData
names

The name of this resource listed in different languages.

list Name
past_values

A list of move resource value changes across version groups of the game.

list PastMoveStatValues
stat_changes

A list of stats this moves effects and how much it effects them.

list MoveStatChange
super_contest_effect

The effect the move has when used in a super contest.

APIResource (SuperContestEffect)
target

The type of target that will receive the effects of the attack.

NamedAPIResource (MoveTarget)
type

The elemental type of this move.

NamedAPIResource (Type)

ContestComboSets

NameDescriptionType
normal

A detail of moves this move can be used before or after, granting additional appeal points in contests.

ContestComboDetail
super

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

ContestComboDetail

ContestComboDetail

NameDescriptionType
use_before

A list of moves to use before this move.

list NamedAPIResource (Move)
use_after

A list of moves to use after this move.

list NamedAPIResource (Move)

MoveFlavorText

NameDescriptionType
flavor_text

The localized flavor text for an api resource in a specific language.

string
language

The language this name is in.

list NamedAPIResource (Move)
version_group

The version group that uses this flavor text.

list NamedAPIResource (Move)

MoveMetaData

NameDescriptionType
ailment

The status ailment this move inflicts on its target.

NamedAPIResource (MoveAilment)
category

The category of move this move falls under, e.g. damage or ailment.

NamedAPIResource (Move)
min_hits

The minimum number of times this move hits. Null if it always only hits once.

integer
max_hits

The maximum number of times this move hits. Null if it always only hits once.

integer
min_turns

The minimum number of turns this move continues to take effect. Null if it always only lasts one turn.

integer
max_turns

The maximum number of turns this move continues to take effect. Null if it always only lasts one turn.

integer
drain

HP drain (if positive) or Recoil damage (if negative), in percent of damage done.

integer
healing

The amount of hp gained by the attacking Pokemon, in percent of it's maximum HP.

integer
crit_rate

Critical hit rate bonus.

integer
ailment_chance

The likelihood this attack will cause an ailment.

integer
flinch_chance

The likelihood this attack will cause the target Pokémon to flinch.

integer
stat_chance

The likelihood this attack will cause a stat change in the target Pokémon.

integer

MoveStatChange

NameDescriptionType
change

The amount of change.

integer
stat

The stat being affected.

NamedAPIResource (Stat)

PastMoveStatValues

NameDescriptionType
accuracy

The percent value of how likely this move is to be successful.

integer
effect_chance

The percent value of how likely it is this moves effect will take effect.

integer
power

The base power of this move with a value of 0 if it does not have a base power.

integer
pp

Power points. The number of times this move can be used.

integer
effect_entries

The effect of this move listed in different languages.

list VerboseEffect
type

The elemental type of this move.

NamedAPIResource (Type)
version_group

The version group in which these move stat values were in effect.

NamedAPIResource (VersionGroup)

Move Ailments

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

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

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

MoveAilment

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
moves

A list of moves that cause this ailment.

list NamedAPIResource (Move)
names

The name of this resource listed in different languages.

list Name

Move Battle Styles

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

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

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

MoveBattleStyle

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name

Move Categories

Very general categories that loosely group move effects.

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

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

ModelName

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
moves

A list of moves that fall into this category.

list NamedAPIResource (Move)
descriptions

The description of this resource listed in different languages.

list Description

Move Damage Classes

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

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

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

MoveDamageClass

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
descriptions

The description of this resource listed in different languages.

list Description
moves

A list of moves that fall into this damage class.

list NamedAPIResource (Move)
names

The name of this resource listed in different languages.

list Name

Move Learn Methods

Methods by which Pokémon can learn moves.

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

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

MoveLearnMethod

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
descriptions

The description of this resource listed in different languages.

list Description
names

The name of this resource listed in different languages.

list Name
version_groups

A list of version groups where moves can be learned through this method.

list NamedAPIResource (VersionGroup)

Move Targets

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

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

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

MoveTarget

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
descriptions

The description of this resource listed in different languages.

list Description
moves

A list of moves that that are directed at this target.

list NamedAPIResource (Move)
names

The name of this resource listed in different languages.

list Name

Pokemon

Abilities

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

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

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

Ability

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
is_main_series

Whether or not this ability originated in the main series of the video games.

boolean
generation

The generation this ability originated in.

NamedAPIResource (Generation)
names

The name of this resource listed in different languages.

list Name
effect_entries

The effect of this ability listed in different languages.

list VerboseEffect
effect_changes

The list of previous effects this ability has had across version groups.

list AbilityEffectChange
flavor_text_entries

The flavor text of this ability listed in different languages.

list AbilityFlavorText
pokemon

A list of Pokémon that could potentially have this ability.

list AbilityPokemon

AbilityEffectChange

NameDescriptionType
effect_entries

The previous effect of this ability listed in different languages.

list Effect
version_group

The version group in which the previous effect of this ability originated.

NamedAPIResource (VersionGroup)

AbilityFlavorText

NameDescriptionType
flavor_text

The localized name for an API resource in a specific language.

string
language

The language this text resource is in.

NamedAPIResource (Language)
version_group

The version group that uses this flavor text.

NamedAPIResource (VersionGroup)

AbilityPokemon

NameDescriptionType
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 pokemon.

integer
pokemon

The Pokémon this ability could belong to.

NamedAPIResource (Pokemon)

Characteristics

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

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

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

Characteristic

NameDescriptionType
id

The identifier for this 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

Egg Groups

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

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

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

EggGroup

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
pokemon_species

A list of all Pokémon species that are members of this egg group.

list NamedAPIResource (PokemonSpecies)

Genders

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

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

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

Gender

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
pokemon_species_details

A list of Pokémon species that can be this gender and how likely it is that they will be.

list PokemonSpeciesGender
required_for_evolution

A list of Pokémon species that required this gender in order for a Pokémon to evolve into them.

list NamedAPIResource (PokemonSpecies)

PokemonSpeciesGender

NameDescriptionType
rate

The chance of this Pokémon being female, in eighths; or -1 for genderless.

integer
pokemon_species

A Pokémon species that can be the referenced gender.

NamedAPIResource (PokemonSpecies)

Growth Rates

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

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

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

GrowthRate

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
formula

The formula used to calculate the rate at which the Pokémon species gains level.

string
descriptions

The descriptions of this characteristic listed in different languages.

list Description
levels

A list of levels and the amount of experienced needed to atain them based on this growth rate.

list GrowthRateExperienceLevel
pokemon_species

A list of Pokémon species that gain levels at this growth rate.

list NamedAPIResource (PokemonSpecies)

GrowthRateExperienceLevel

NameDescriptionType
level

The level gained.

integer
experience

The amount of experience required to reach the referenced level.

integer

Natures

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

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

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

Nature

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
decreased_stat

The stat decreased by 10% in Pokémon with this nature.

NamedAPIResource (Stat)
increased_stat

The stat increased by 10% in Pokémon with this nature.

NamedAPIResource (Stat)
hates_flavor

The flavor hated by Pokémon with this nature.

NamedAPIResource (BerryFlavor)
likes_flavor

The flavor liked by Pokémon with this nature.

NamedAPIResource (BerryFlavor)
pokeathlon_stat_changes

A list of Pokéathlon stats this nature effects and how much it effects them.

list NatureStatChange
move_battle_style_preferences

A list of battle styles and how likely a Pokémon with this nature is to use them in the Battle Palace or Battle Tent.

list MoveBattleStylePreference
names

The name of this resource listed in different languages.

list Name

NatureStatChange

NameDescriptionType
max_change

The amount of change.

integer
pokeathlon_stat

The stat being affected.

NamedAPIResource (PokeathlonStat)

MoveBattleStylePreference

NameDescriptionType
low_hp_preference

Chance of using the move, in percent, if HP is under one half.

integer
high_hp_preference

Chance of using the move, in percent, if HP is over one half.

integer
move_battle_style

The move battle style.

NamedAPIResource (MoveBattleStyle)

Pokeathlon Stats

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

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

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

PokeathlonStat

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
affecting_natures

A detail of natures which affect this Pokéathlon stat positively or negatively.

NaturePokeathlonStatAffectSets

NaturePokeathlonStatAffectSets

NameDescriptionType
increase

A list of natures and how they change the referenced Pokéathlon stat.

list NaturePokeathlonStatAffect
decrease

A list of natures and how they change the referenced Pokéathlon stat.

list NaturePokeathlonStatAffect

NaturePokeathlonStatAffect

NameDescriptionType
max_change

The maximum amount of change to the referenced Pokéathlon stat.

integer
nature

The nature causing the change.

NamedAPIResource (Nature)

Pokemon

Pokémon are the creatures that inhabit the world of the Pokémon games. They can be caught using Pokéballs and trained by battling with other Pokémon. Each Pokémon belongs to a specific species but may take on a variant which makes it differ from other Pokémon of the same species, such as base stats, available abilities and typings. See Bulbapedia for greater detail.

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

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

Pokemon

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
base_experience

The base experience gained for defeating this Pokémon.

integer
height

The height of this Pokémon in decimetres.

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 weight of this Pokémon in hectograms.

integer
abilities

A list of abilities this Pokémon could potentially have.

list PokemonAbility
forms

A list of forms this Pokémon can take on.

list NamedAPIResource (PokemonForm)
game_indices

A list of game indices relevent to Pokémon item by generation.

list VersionGameIndex
held_items

A list of items this Pokémon may be holding when encountered.

list PokemonHeldItem
location_area_encounters

A link to a list of location areas, as well as encounter details pertaining to specific versions.

string
moves

A list of moves along with learn methods and level details pertaining to specific version groups.

list PokemonMove
sprites

A set of sprites used to depict this Pokémon in the game.

PokemonSprites
species

The species this Pokémon belongs to.

NamedAPIResource (PokemonSpecies)
stats

A list of base stat values for this Pokémon.

list PokemonStat
types

A list of details showing types this Pokémon has.

list PokemonType

PokemonAbility

NameDescriptionType
is_hidden

Whether or not this is a hidden ability.

boolean
slot

The slot this ability occupies in this Pokémon species.

integer
ability

The ability the Pokémon may have.

NamedAPIResource (Ability)

PokemonType

NameDescriptionType
slot

The order the Pokémon's types are listed in.

integer
type

The type the referenced Pokémon has.

NamedAPIResource (Type)

PokemonHeldItem

NameDescriptionType
item

The item the referenced Pokémon holds.

NamedAPIResource (Item)
version_details

The details of the different versions in which the item is held.

list PokemonHeldItemVersion

PokemonHeldItemVersion

NameDescriptionType
version

The version in which the item is held.

NamedAPIResource (Version)
rarity

How often the item is held.

integer

PokemonMove

NameDescriptionType
move

The move the Pokémon can learn.

NamedAPIResource (Move)
version_group_details

The details of the version in which the Pokémon can learn the move.

list PokemonMoveVersion

PokemonMoveVersion

NameDescriptionType
move_learn_method

The method by which the move is learned.

NamedAPIResource (MoveLearnMethod)
version_group

The version group in which the move is learned.

NamedAPIResource (VersionGroup)
level_learned_at

The minimum level to learn the move.

integer

PokemonStat

NameDescriptionType
stat

The stat the Pokémon has.

NamedAPIResource (Stat)
effort

The effort points (EV) the Pokémon has in the stat.

integer
base_stat

The base value of the stat.

integer

PokemonSprites

NameDescriptionType
front_default

The default depiction of this Pokémon from the front in battle.

string
front_shiny

The shiny depiction of this Pokémon from the front in battle.

string
front_female

The female depiction of this Pokémon from the front in battle.

string
front_shiny_female

The shiny female depiction of this Pokémon from the front in battle.

string
back_default

The default depiction of this Pokémon from the back in battle.

string
back_shiny

The shiny depiction of this Pokémon from the back in battle.

string
back_female

The female depiction of this Pokémon from the back in battle.

string
back_shiny_female

The shiny female depiction of this Pokémon from the back in battle.

string

LocationAreaEncounter

NameDescriptionType
location_area

The location area the referenced Pokémon can be encountered in.

NamedAPIResource (LocationArea)
version_details

A list of versions and encounters with the referenced Pokémon that might happen.

list VersionEncounterDetail

Pokemon Colors

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

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

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

PokemonColor

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
pokemon_species

A list of the Pokémon species that have this color.

list NamedAPIResource (PokemonSpecies)

Pokemon Forms

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

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

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

PokemonForm

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
order

The order in which forms should be sorted within all forms. Multiple forms may have equal order, in which case they should fall back on sorting by name.

integer
form_order

The order in which forms should be sorted within a species' forms.

integer
is_default

True for exactly one form used as the default for each Pokémon.

boolean
is_battle_only

Whether or not this form can only happen during battle.

boolean
is_mega

Whether or not this form requires mega evolution.

boolean
form_name

The name of this form.

string
pokemon

The Pokémon that can take on this form.

NamedAPIResource (Pokemon)
sprites

A set of sprites used to depict this Pokémon form in the game.

PokemonFormSprites
version_group

The version group this Pokémon form was introduced in.

NamedAPIResource (VersionGroup)
names

The form specific full name of this Pokémon form, or empty if the form does not have a specific name.

list Name
form_names

The form specific form name of this Pokémon form, or empty if the form does not have a specific name.

list Name

PokemonFormSprites

NameDescriptionType
front_default

The default depiction of this Pokémon form from the front in battle.

string
front_shiny

The shiny depiction of this Pokémon form from the front in battle.

string
back_default

The default depiction of this Pokémon form from the back in battle.

string
back_shiny

The shiny depiction of this Pokémon form from the back in battle.

string

Pokemon Habitats

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

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

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

PokemonHabitat

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
names

The name of this resource listed in different languages.

list Name
pokemon_species

A list of the Pokémon species that can be found in this habitat.

list NamedAPIResource (PokemonSpecies)

Pokemon Shapes

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

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

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

PokemonShape

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
awesome_names

The "scientific" name of this Pokémon shape listed in different languages.

list AwesomeName
names

The name of this resource listed in different languages.

list Name
pokemon_species

A list of the Pokémon species that have this shape.

list PokemonSpecies

AwesomeName

NameDescriptionType
awesome_name

The localized "scientific" name for an API resource in a specific language.

string
language

The language this "scientific" name is in.

NamedAPIResource (Language)

Pokemon Species

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

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

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

PokemonSpecies

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this 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 has visual gender differences.

boolean
forms_switchable

Whether or not this Pokémon has multiple forms and can switch between them.

boolean
growth_rate

The rate at which this Pokémon species gains levels.

NamedAPIResource (GrowthRate)
pokedex_numbers

A list of Pokedexes and the indexes reserved within them for this Pokémon species.

list PokemonSpeciesDexEntry
egg_groups

A list of egg groups this Pokémon species is a member of.

list NamedAPIResource (EggGroup)
color

The color of this Pokémon for Pokédex search.

NamedAPIResource (PokemonColor)
shape

The shape of this Pokémon for Pokédex search.

NamedAPIResource (PokemonShape)
evolves_from_species

The Pokémon species that evolves into this Pokemon_species.

NamedAPIResource (PokemonSpecies)
evolution_chain

The evolution chain this Pokémon species is a member of.

APIResource (EvolutionChain)
habitat

The habitat this Pokémon species can be encountered in.

NamedAPIResource (PokemonHabitat)
generation

The generation this Pokémon species was introduced in.

NamedAPIResource (Generation)
names

The name of this resource listed in different languages.

list Name
pal_park_encounters

A list of encounters that can be had with this Pokémon species in pal park.

list PalParkEncounterArea
flavor_text_entries

A list of flavor text entries for this Pokémon species.

list FlavorText
form_descriptions

Descriptions of different forms Pokémon take on within the Pokémon species.

list Description
genera

The genus of this Pokémon species listed in multiple languages.

list Genus
varieties

A list of the Pokémon that exist within this Pokémon species.

list PokemonSpeciesVariety

Genus

NameDescriptionType
genus

The localized genus for the referenced Pokémon species

string
language

The language this genus is in.

NamedAPIResource (Language)

PokemonSpeciesDexEntry

NameDescriptionType
entry_number

The index number within the Pokédex.

integer
pokedex

The Pokédex the referenced Pokémon species can be found in.

NamedAPIResource (Pokedex)

PalParkEncounterArea

NameDescriptionType
base_score

The base score given to the player when the referenced Pokémon is caught during a pal park run.

integer
rate

The base rate for encountering the referenced Pokémon in this pal park area.

integer
area

The pal park area where this encounter happens.

NamedAPIResource (PalParkArea)

PokemonSpeciesVariety

NameDescriptionType
is_default

Whether this variety is the default variety.

boolean
pokemon

The Pokémon variety.

NamedAPIResource (Pokemon)

Stats

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

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

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

Stat

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
game_index

ID the games use for this stat.

integer
is_battle_only

Whether this stat only exists within a battle.

boolean
affecting_moves

A detail of moves which affect this stat positively or negatively.

MoveStatAffectSets
affecting_natures

A detail of natures which affect this stat positively or negatively.

NatureStatAffectSets
characteristics

A list of characteristics that are set on a Pokémon when its highest base stat is this stat.

APIResource (Characteristic)
move_damage_class

The class of damage this stat is directly related to.

NamedAPIResource (MoveDamageClass)
names

The name of this resource listed in different languages.

list Name

MoveStatAffectSets

NameDescriptionType
increase

A list of moves and how they change the referenced stat.

list MoveStatAffect
decrease

A list of moves and how they change the referenced stat.

list MoveStatAffect

MoveStatAffect

NameDescriptionType
change

The maximum amount of change to the referenced stat.

integer
move

The move causing the change.

NamedAPIResource (Move)

NatureStatAffectSets

NameDescriptionType
increase

A list of natures and how they change the referenced stat.

list NamedAPIResource (Nature)
decrease

A list of nature sand how they change the referenced stat.

list NamedAPIResource (Nature)

Types

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

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

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

Type

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this resource.

string
damage_relations

A detail of how effective this type is toward others and vice versa.

TypeRelations
game_indices

A list of game indices relevent to this item by generation.

list GenerationGameIndex
generation

The generation this type was introduced in.

NamedAPIResource (Generation)
move_damage_class

The class of damage inflicted by this type.

NamedAPIResource (MoveDamageClass)
names

The name of this resource listed in different languages.

list Name
pokemon

A list of details of Pokémon that have this type.

list TypePokemon
moves

A list of moves that have this type.

list NamedAPIResource (Move)

TypePokemon

NameDescriptionType
slot

The order the Pokémon's types are listed in.

integer
pokemon

The Pokémon that has the referenced type.

NamedAPIResource (Pokemon)

TypeRelations

NameDescriptionType
no_damage_to

A list of types this type has no effect on.

list NamedAPIResource (Type)
half_damage_to

A list of types this type is not very effect against.

list NamedAPIResource (Type)
double_damage_to

A list of types this type is very effect against.

list NamedAPIResource (Type)
no_damage_from

A list of types that have no effect on this type.

list NamedAPIResource (Type)
half_damage_from

A list of types that are not very effective against this type.

list NamedAPIResource (Type)
double_damage_from

A list of types that are very effective against this type.

list NamedAPIResource (Type)

Utility

Languages

Languages for translations of API resource information.

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

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

Language

NameDescriptionType
id

The identifier for this resource.

integer
name

The name for this 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 resource listed in different languages.

list Name

Common Models

APIResource

NameDescriptionType
url

The URL of the referenced resource.

string

Description

NameDescriptionType
description

The localized description for an API resource in a specific language.

string
language

The language this name is in.

NamedAPIResource (Language)

Effect

NameDescriptionType
effect

The localized effect text for an API resource in a specific language.

string
language

The language this effect is in.

NamedAPIResource (Language)

Encounter

NameDescriptionType
min_level

The lowest level the Pokémon could be encountered at.

integer
max_level

The highest level the Pokémon could be encountered at.

integer
condition_values

A list of condition values that must be in effect for this encounter to occur.

list NamedAPIResource (EncounterConditionValue)
chance

Percent chance that this encounter will occur.

integer
method

The method by which this encounter happens.

NamedAPIResource (EncounterMethod)

FlavorText

NameDescriptionType
flavor_text

The localized flavor text for an API resource in a specific language.

string
language

The language this name is in.

NamedAPIResource (Language)
version

The game version this flavor text is extracted from.

NamedAPIResource (Version)

GenerationGameIndex

NameDescriptionType
game_index

The internal id of an API resource within game data.

integer
generation

The generation relevent to this game index.

NamedAPIResource (Generation)

MachineVersionDetail

NameDescriptionType
machine

The machine that teaches a move from an item.

APIResource (Machine)
version_group

The version group of this specific machine.

NamedAPIResource (VersionGroup)

Name

NameDescriptionType
name

The localized name for an API resource in a specific language.

string
language

The language this name is in.

NamedAPIResource (Language)

NamedAPIResource

NameDescriptionType
name

The name of the referenced resource.

string
url

The URL of the referenced resource.

string

VerboseEffect

NameDescriptionType
effect

The localized effect text for an API resource in a specific language.

string
short_effect

The localized effect text in brief.

string
language

The language this effect is in.

NamedAPIResource (Language)

VersionEncounterDetail

NameDescriptionType
version

The game version this encounter happens in.

NamedAPIResource (Version)
max_chance

The total percentage of all encounter potential.

integer
encounter_details

A list of encounters and their specifics.

list Encounter

VersionGameIndex

NameDescriptionType
game_index

The internal id of an API resource within game data.

integer
version

The version relevent to this game index.

NamedAPIResource (Version)

VersionGroupFlavorText

NameDescriptionType
text

The localized name for an API resource in a specific language.

string
language

The language this name is in.

NamedAPIResource (Language)
version_group

The version group which uses this flavor text.

NamedAPIResource (VersionGroup)