Skip to content

Pokémon Resource#

Get Pokémon by name#

GET /pokemon/{name}

Returns an array of Pokémon objects containing all the forms of the Pokémon specified the Pokémon name.

Example Request#

1
2
3
curl -i -X GET \
  -H "User-Agent: BastionDiscordBot (https://bastionbot.org, v6.3)" \
  https://pokeapi.bastionbot.org/v1/pokemon/pikachu

Example Response#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
[
  {
    "number": "25",
    "name": "Pikachu",
    "species": "Mouse",
    "types": [
      "Electric"
    ],
    "abilities": {
      "normal": [
        "Static"
      ],
      "hidden": [
        "Lightning Rod"
      ]
    },
    "eggGroups": [
      "Field",
      "Fairy"
    ],
    "gender": [
      50,
      50
    ],
    "height": "1'04\"",
    "weight": "13.2 lbs.",
    "family": {
      "id": 10,
      "evolutionStage": 2,
      "evolutionLine": [
        "Pichu",
        "Pikachu",
        "Raichu"
      ]
    },
    "starter": false,
    "legendary": false,
    "mythical": false,
    "ultraBeast": false,
    "mega": false,
    "gen": 1,
    "sprite": "https://pokeres.bastionbot.org/images/pokemon/25.png"
  }
]

Get Pokémon by Pokédex number#

GET /pokemon/{number}

Returns an array of Pokémon objects containing all the forms of the Pokémon specified the Pokédex number.

Example Request#

1
2
3
curl -i -X GET \
  -H "User-Agent: BastionDiscordBot (https://bastionbot.org, v6.3)" \
  https://pokeapi.bastionbot.org/v1/pokemon/658

Example Response#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
[
  {
    "number": "658",
    "name": "Greninja",
    "species": "Ninja",
    "types": [
      "Water",
      "Dark"
    ],
    "abilities": {
      "normal": [
        "Torrent"
      ],
      "hidden": [
        "Protean"
      ]
    },
    "eggGroups": [
      "Water 1"
    ],
    "gender": [
      87.5,
      12.5
    ],
    "height": "4'11\"",
    "weight": "88.2 lbs.",
    "family": {
      "id": 331,
      "evolutionStage": 3,
      "evolution-line": [
        "Froakie",
        "Frogadier",
        "Greninja"
      ]
    },
    "starter": false,
    "legendary": false,
    "mythical": false,
    "ultraBeast": false,
    "mega": false,
    "gen": 6,
    "sprite": "https://pokeres.bastionbot.org/images/pokemon/658.png"
  },
  {
    "number": "658",
    "name": "Ash-Greninja",
    "species": "Ninja",
    "types": [
      "Water",
      "Dark"
    ],
    "abilities": {
      "normal": [
        "Torrent"
      ],
      "hidden": [
        "Battle Bond"
      ]
    },
    "eggGroups": [
      "Water 1"
    ],
    "gender": [
      87.5,
      12.5
    ],
    "height": "4'11\"",
    "weight": "88.2 lbs.",
    "family": {
      "id": 331,
      "evolutionStage": 3,
      "evolution-line": [
        "Froakie",
        "Frogadier",
        "Greninja"
      ]
    },
    "starter": false,
    "legendary": false,
    "mythical": false,
    "ultraBeast": false,
    "mega": false,
    "gen": 6,
    "sprite": "https://pokeres.bastionbot.org/images/pokemon/658-ash.png"
  }
]

Get Pokémon Counts#

GET /pokemon/counts

Returns a Pokémon Counts object containing the number of Pokémon in each generation and the total number of Pokémon in the Pokémon World.

Example Request#

1
2
3
curl -i -X GET -H \
  "User-Agent: BastionDiscordBot (https://bastionbot.oorg, v6.3)" \
  https://pokeapi.bastionbot.org/v1/pokemon/counts

Example Response#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "gen1": 151,
  "gen2": 100,
  "gen3": 135,
  "gen4": 107,
  "gen5": 156,
  "gen6": 72,
  "gen7": 86,
  "total": 807
}

Pokémon Models#

Pokémon Object#

Pokémon Structure
Field Type Description
number integer The Pokédex number of the Pokémon
name string The name of the Pokémon
species string The species the Pokémon belongs to
types array of Pokémon types The type of the Pokémon
abilities array of normal and hidden Pokémon abilities The abilities of the Pokémon
eggGroups array of Pokémon egg groups The egg groups the Pokémon belong to
height string The height of the Pokémon in feet
weight string The weight of the Pokémon in pounds
family Pokémon family object The family id, evolution stage and evolution line of the Pokémon
starter bool Is it a starter Pokémon
legendary bool Is it a legendary Pokémon
mythical bool Is it a mythical Pokémon
ultraBeast bool Is it a ultra beast
mega bool Is it mega evolved form of the Pokémon
gen integer The generation the Pokémon was first discovered
sprite string The URL of an image of the Pokémon

Pokémon Family Object#

Pokémon Family Structure
Field Type Description
id integer The id of Pokémon family.
evolutionStage integer The evolved stage of the Pokémon in it’s evolution line.
evolutionLine array of Pokémon names The list of Pokémon in it’s evolution line.

Pokémon Counts Object#

Pokémon Counts Structure
Field Type Description
gen1 integer The number of Pokémon discovered in this generation.
gen2 integer The number of Pokémon discovered in this generation.
integer The number of Pokémon discovered in this generation.
total integer The total number of Pokémon discovered in the Pokémon World.