PokeAPI

PokéAPI

All the Pokémon data you'll ever need in one place, easily accessible through a modern free open-source RESTful API. What is this? This is a full RESTful API…

Media & content#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

All the Pokémon data you'll ever need in one place, easily accessible through a modern free open-source RESTful API.

What is this?

This is a full RESTful API linked to an extensive database detailing everything about the Pokémon main game series.

We've covered everything from Pokémon to Berry Flavors.

Where do I start?

We have awesome documentation on how to use this API. It takes minutes to get started.

This API will always be publicly available and will never require any extensive setup process to consume.

Created by Paul Hallett and other PokéAPI contributors around the world. Pokémon and Pokémon character names are trademarks of Nintendo.

Endpoints 102

pokemon

  • GETList abilities/api/v2/ability/?limit=0&offset=0&q=stringAbilities 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.…
  • GETGet ability/api/v2/ability/:id/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.…
  • GETList characteristics/api/v2/characteristic/?limit=0&offset=0Characteristics 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…
  • GETGet characteristic/api/v2/characteristic/:id/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…
  • GETList egg groups/api/v2/egg-group/?limit=0&offset=0&q=stringEgg 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…
  • GETGet egg group/api/v2/egg-group/:id/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…
  • GETList genders/api/v2/gender/?limit=0&offset=0&q=stringGenders were introduced in Generation II for the purposes of breeding Pokémon but can also result in visual differences or even different evolutionary lines.…
  • GETGet gender/api/v2/gender/:id/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.…
  • GETList growth rates/api/v2/growth-rate/?limit=0&offset=0&q=stringGrowth rates are the speed with which Pokémon gain levels through experience. Check out Bulbapedia for greater detail.
  • GETGet growth rate/api/v2/growth-rate/:id/Growth rates are the speed with which Pokémon gain levels through experience. Check out Bulbapedia for greater detail.
  • GETList move damage classes/api/v2/move-damage-class/?limit=0&offset=0&q=stringDamage classes moves can have, e.g. physical, special, or non-damaging.
  • GETGet move damage class/api/v2/move-damage-class/:id/Damage classes moves can have, e.g. physical, special, or non-damaging.
  • GETList natures/api/v2/nature/?limit=0&offset=0&q=stringNatures influence how a Pokémon's stats grow. See Bulbapedia for greater detail.
  • GETGet nature/api/v2/nature/:id/Natures influence how a Pokémon's stats grow. See Bulbapedia for greater detail.
  • GETList pokemon/api/v2/pokemon/?limit=0&offset=0&q=stringPoké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…
  • GETGet pokemon/api/v2/pokemon/:id/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…
  • GETList pokemon colors/api/v2/pokemon-color/?limit=0&offset=0&q=stringColors 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…
  • GETGet pokemon color/api/v2/pokemon-color/:id/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…
  • GETList pokemon forms/api/v2/pokemon-form/?limit=0&offset=0&q=stringSome 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…
  • GETGet pokemon form/api/v2/pokemon-form/:id/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…
  • GETList pokemom habitas/api/v2/pokemon-habitat/?limit=0&offset=0&q=stringHabitats are generally different terrain Pokémon can be found in but can also be areas designated for rare or legendary Pokémon.
  • GETGet pokemom habita/api/v2/pokemon-habitat/:id/Habitats are generally different terrain Pokémon can be found in but can also be areas designated for rare or legendary Pokémon.
  • GETList pokemon shapes/api/v2/pokemon-shape/?limit=0&offset=0&q=stringShapes used for sorting Pokémon in a Pokédex.
  • GETGet pokemon shape/api/v2/pokemon-shape/:id/Shapes used for sorting Pokémon in a Pokédex.
  • GETList pokemon species/api/v2/pokemon-species/?limit=0&offset=0&q=stringA 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…
  • GETGet pokemon species/api/v2/pokemon-species/:id/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…
  • GETList pokeathlon stats/api/v2/pokeathlon-stat/?limit=0&offset=0&q=stringPokeathlon 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…
  • GETGet pokeathlon stat/api/v2/pokeathlon-stat/:id/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…
  • GETList stats/api/v2/stat/?limit=0&offset=0&q=stringStats 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…
  • GETGet stat/api/v2/stat/:id/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…
  • GETList types/api/v2/type/?limit=0&offset=0&q=stringTypes 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…
  • GETGet types/api/v2/type/:id/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…

evolution

  • GETList evolution chains/api/v2/evolution-chain/?limit=0&offset=0Evolution 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…
  • GETGet evolution chain/api/v2/evolution-chain/:id/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…
  • GETList evolution triggers/api/v2/evolution-trigger/?limit=0&offset=0&q=stringEvolution triggers are the events and conditions that cause a Pokémon to evolve. Check out Bulbapedia for greater detail.
  • GETGet evolution trigger/api/v2/evolution-trigger/:id/Evolution triggers are the events and conditions that cause a Pokémon to evolve. Check out Bulbapedia for greater detail.
  • GETList evolution variables/api/v2/evolution-variable/?limit=0&offset=0&q=stringEvolution variables represent parameters (such as Encryption Constant and Personality Value) used in boolean expressions for form-branching evolutions. Check…
  • GETGet evolution variable/api/v2/evolution-variable/:id/Evolution variables represent parameters (such as Encryption Constant and Personality Value) used in boolean expressions for form-branching evolutions. Check…

berries

  • GETList berries/api/v2/berry/?limit=0&offset=0&q=stringBerries are small fruits that can provide HP and status condition restoration, stat enhancement, and even damage negation when eaten by Pokémon. Check out…
  • GETGet a berry/api/v2/berry/:id/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…
  • GETList berry firmness/api/v2/berry-firmness/?limit=0&offset=0&q=stringBerries can be soft or hard. Check out Bulbapedia for greater detail.
  • GETGet berry by firmness/api/v2/berry-firmness/:id/Berries can be soft or hard. Check out Bulbapedia for greater detail.
  • GETList berry flavors/api/v2/berry-flavor/?limit=0&offset=0&q=stringFlavors determine whether a Pokémon will benefit or suffer from eating a berry based on their nature. Check out Bulbapedia for greater detail.
  • GETGet berries by flavor/api/v2/berry-flavor/:id/Flavors determine whether a Pokémon will benefit or suffer from eating a berry based on their nature. Check out Bulbapedia for greater detail.

items

  • GETList items/api/v2/item/?limit=0&offset=0&q=stringAn 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…
  • GETGet item/api/v2/item/:id/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…
  • GETList item categories/api/v2/item-category/?limit=0&offset=0&q=stringItem categories determine where items will be placed in the players bag.
  • GETGet item category/api/v2/item-category/:id/Item categories determine where items will be placed in the players bag.
  • GETList item attributes/api/v2/item-attribute/?limit=0&offset=0&q=stringItem attributes define particular aspects of items, e.g."usable in battle" or "consumable".
  • GETGet item attribute/api/v2/item-attribute/:id/Item attributes define particular aspects of items, e.g."usable in battle" or "consumable".
  • GETList item fling effects/api/v2/item-fling-effect/?limit=0&offset=0&q=stringThe various effects of the move"Fling" when used with different items.
  • GETGet item fling effect/api/v2/item-fling-effect/:id/The various effects of the move"Fling" when used with different items.
  • GETList item pockets/api/v2/item-pocket/?limit=0&offset=0&q=stringPockets within the players bag used for storing items by category.
  • GETGet item pocket/api/v2/item-pocket/:id/Pockets within the players bag used for storing items by category.
  • GETList currencies/api/v2/currency/?limit=0&offset=0&q=stringCurrencies used to buy items.
  • GETGet currency/api/v2/currency/:id/Currencies used to buy items.

machines

  • GETList machines/api/v2/machine/?limit=0&offset=0Machines 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…
  • GETGet machine/api/v2/machine/:id/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…

location

  • GETList locations/api/v2/location/?limit=0&offset=0&q=stringLocations that can be visited within the games. Locations make up sizable portions of regions, like cities or routes.
  • GETGet location/api/v2/location/:id/Locations that can be visited within the games. Locations make up sizable portions of regions, like cities or routes.
  • GETList location areas/api/v2/location-area/?limit=0&offset=0Location areas are sections of areas, such as floors in a building or cave. Each area has its own set of possible Pokémon encounters.
  • GETGet location area/api/v2/location-area/:id/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.
  • GETList pal park areas/api/v2/pal-park-area/?limit=0&offset=0&q=stringAreas used for grouping Pokémon encounters in Pal Park. They're like habitats that are specific to Pal Park.
  • GETGet pal park area/api/v2/pal-park-area/:id/Areas used for grouping Pokémon encounters in Pal Park. They're like habitats that are specific to Pal Park.
  • GETList regions/api/v2/region/?limit=0&offset=0&q=stringA 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…
  • GETGet region/api/v2/region/:id/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…

moves

  • GETList moves/api/v2/move/?limit=0&offset=0&q=stringMoves 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…
  • GETGet move/api/v2/move/:id/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…
  • GETList move meta ailments/api/v2/move-ailment/?limit=0&offset=0&q=stringMove Ailments are status conditions caused by moves used during battle. See Bulbapedia for greater detail.
  • GETGet move meta ailment/api/v2/move-ailment/:id/Move Ailments are status conditions caused by moves used during battle. See Bulbapedia for greater detail.
  • GETList move battle styles/api/v2/move-battle-style/?limit=0&offset=0&q=stringStyles of moves when used in the Battle Palace. See Bulbapedia) for greater detail.
  • GETGet move battle style/api/v2/move-battle-style/:id/Styles of moves when used in the Battle Palace. See Bulbapedia) for greater detail.
  • GETList move meta categories/api/v2/move-category/?limit=0&offset=0&q=stringVery general categories that loosely group move effects.
  • GETGet move meta category/api/v2/move-category/:id/Very general categories that loosely group move effects.
  • GETList move learn methods/api/v2/move-learn-method/?limit=0&offset=0&q=stringMethods by which Pokémon can learn moves.
  • GETGet move learn method/api/v2/move-learn-method/:id/Methods by which Pokémon can learn moves.
  • GETList move targets/api/v2/move-target/?limit=0&offset=0&q=stringTargets moves can be directed at during battle. Targets can be Pokémon, environments or even other moves.
  • GETGet move target/api/v2/move-target/:id/Targets moves can be directed at during battle. Targets can be Pokémon, environments or even other moves.

encounters

  • GETList encounter methods/api/v2/encounter-method/?limit=0&offset=0&q=stringMethods by which the player might can encounter Pokémon in the wild, e.g., walking in tall grass. Check out Bulbapedia for greater detail.
  • GETGet encounter method/api/v2/encounter-method/:id/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.
  • GETList encounter conditions/api/v2/encounter-condition/?limit=0&offset=0&q=stringConditions which affect what pokemon might appear in the wild, e.g., day or night.
  • GETGet encounter condition/api/v2/encounter-condition/:id/Conditions which affect what pokemon might appear in the wild, e.g., day or night.
  • GETList encounter condition values/api/v2/encounter-condition-value/?limit=0&offset=0&q=stringEncounter condition values are the various states that an encounter condition can have, i.e., time of day can be either day or night.
  • GETGet encounter condition value/api/v2/encounter-condition-value/:id/Encounter condition values are the various states that an encounter condition can have, i.e., time of day can be either day or night.
  • GETGet pokemon encounter/api/v2/pokemon/:pokemon_id/encountersHandles Pokemon Encounters as a sub-resource.

games

  • GETList genrations/api/v2/generation/?limit=0&offset=0&q=stringA 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,…
  • GETGet genration/api/v2/generation/:id/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,…
  • GETList pokedex/api/v2/pokedex/?limit=0&offset=0&q=stringA 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…
  • GETGet pokedex/api/v2/pokedex/:id/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…
  • GETList versions/api/v2/version/?limit=0&offset=0&q=stringVersions of the games, e.g., Red, Blue or Yellow.
  • GETGet version/api/v2/version/:id/Versions of the games, e.g., Red, Blue or Yellow.
  • GETList version groups/api/v2/version-group/?limit=0&offset=0&q=stringVersion groups categorize highly similar versions of the games.
  • GETGet version group/api/v2/version-group/:id/Version groups categorize highly similar versions of the games.

utility

  • GETGet API metadata/api/v2/meta/Returns metadata about the current deployed version of the API, including the git commit hash, deploy date, and tag (if any).
  • GETList languages/api/v2/language/?limit=0&offset=0&q=stringLanguages for translations of API resource information.
  • GETGet language/api/v2/language/:id/Languages for translations of API resource information.

contests

  • GETList contest types/api/v2/contest-type/?limit=0&offset=0&q=stringContest types are categories judges used to weigh a Pokémon's condition in Pokémon contests. Check out Bulbapedia for greater detail.
  • GETGet contest type/api/v2/contest-type/:id/Contest types are categories judges used to weigh a Pokémon's condition in Pokémon contests. Check out Bulbapedia for greater detail.
  • GETList contest effects/api/v2/contest-effect/?limit=0&offset=0Contest effects refer to the effects of moves when used in contests.
  • GETGet contest effect/api/v2/contest-effect/:id/Contest effects refer to the effects of moves when used in contests.
  • GETList super contest effects/api/v2/super-contest-effect/?limit=0&offset=0Super contest effects refer to the effects of moves when used in super contests.
  • GETGet super contest effect/api/v2/super-contest-effect/:id/Super contest effects refer to the effects of moves when used in super contests.

API details

Base URL
https://pokeapi.co
Authentication
None declared in the description
Operations
102 operations on 102 pathsGET 102
Main resources
pokemon 32items 12moves 12games 8location 8encounters 7berries 6contests 6evolution 6utility 3
Response formats
application/json
Description format
OpenAPI 3.1.0, API version 2.10.0

How to test the PokéAPI in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the PokéAPI collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “List abilities” (GET /api/v2/ability/?limit=0&offset=0&q=string), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the PokéAPI?

All the Pokémon data you'll ever need in one place, easily accessible through a modern free open-source RESTful API. What is this? This is a full RESTful API… It is listed under Media & content and has 102 endpoints.

Who publishes the PokéAPI?

It is listed from PokeAPI's public API description (an OpenAPI document), not published by PokeAPI on Swastik Codes. Anyone who controls pokeapi.co can claim the profile by adding a DNS TXT record.

What is the base URL of the PokéAPI?

Requests go to https://pokeapi.co. Endpoint paths are added to this base URL.

How do I authenticate with the PokéAPI?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the PokéAPI have?

102 operations on 102 paths (102 GET). The largest groups are pokemon, items, moves, games.

Is forking the PokéAPI free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.