Get a Pokémon | PokéAPI unofficial

1 parameter

idstringrequired

The Pokémon identifier to retrieve; it can be a string or integer.

1 status code

200Returns a Pokémon object with its name, species, abilities, forms, game indices, held items, location-area encounter URL, moves, stats, and other Pokémon data.

idintegerrequired

namestringrequired

base_experienceintegeroptional

heightintegeroptional

is_defaultbooleanoptional

orderintegeroptional

weightintegeroptional

abilitiesarray<object>required

past_abilitiesarray<object>required

formsarray<object>required

game_indicesarray<object>required

held_itemsarray<object>required

location_area_encountersstringrequired

movesarray<object>required

speciesobjectrequired

spritesobjectrequired

criesobjectrequired

statsarray<object>required

past_statsarray<object>required

typesarray<object>required

past_typesarray<object>required

Error handling

The id path parameter identifies the Pokémon to retrieve; it can be supplied as a string or integer identifier.

import { Client } from "pokéapi";

const client = new Client({
  baseUrl: "https://pokeapi.co",
});

const result = await client.pokemon.get({ id: "9b2f1c10-7a3e-4d54-8c2a-1f6b9e0d4a21" });

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Example Name",
  "base_experience": "example_value",
  "height": "example_value",
  "is_default": true,
  "order": "example_value",
  "weight": "example_value",
  "abilities": [
    {
      "is_hidden": true,
      "slot": 1,
      "ability": {
        "name": "Example Name",
        "url": "https://example.com"
      }
    }
  ],
  "past_abilities": [
    {
      "abilities": [
        {
          "is_hidden": true,
          "slot": 1,
          "ability": {
            "name": "Example Name",
            "url": "https://example.com"
          }
        }
      ],
      "generation": {
        "name": "Example Name",
        "url": "https://example.com"
      }
    }
  ],
  "forms": [
    {
      "name": "Example Name",
      "url": "https://example.com"
    }
  ],
  "game_indices": [
    {
      "game_index": 1,
      "version": {
        "name": "Example Name",
        "url": "https://example.com"
      }
    }
  ],
  "held_items": [
    {
      "pokemon": {
        "name": "Example Name",
        "url": "https://example.com"
      },
      "version_details": [
        {
          "rarity": 1,
          "version": {
            "name": "Example Name",
            "url": "https://example.com"
          }
        }
      ]
    }
  ],
  "location_area_encounters": 42,
  "moves": [
    {
      "move": {
        "name": "Example Name",
        "url": "https://example.com"
      },
      "version_group_details": [
        {
          "level_learned_at": 1,
          "move_learn_method": {
            "name": "Example Name",
            "url": "https://example.com"
          },
          "version_group": {
            "name": "Example Name",
            "url": "https://example.com"
          },
          "order": 1
        }
      ]
    }
  ],
  "species": {
    "name": "Example Name",
    "url": "https://example.com"
  },
  "sprites": {
    "front_default": "example_value"
  },
  "cries": {
    "latest": "example_value",
    "legacy": "example_value"
  },
  "stats": [
    {
      "base_stat": 1,
      "effort": 1,
      "stat": {
        "name": "Example Name",
        "url": "https://example.com"
      }
    }
  ],
  "past_stats": [
    {
      "generation": {
        "name": "Example Name",
        "url": "https://example.com"
      },
      "stats": [
        {
          "base_stat": 1,
          "effort": 1,
          "stat": {
            "name": "Example Name",
            "url": "https://example.com"
          }
        }
      ]
    }
  ],
  "types": [
    {
      "slot": 1,
      "type": {
        "name": "Example Name",
        "url": "https://example.com"
      }
    }
  ],
  "past_types": [
    {
      "generation": {
        "name": "Example Name",
        "url": "https://example.com"
      },
      "types": [
        {
          "slot": 1,
          "pokemon": {
            "name": "Example Name",
            "url": "https://example.com"
          }
        }
      ]
    }
  ]
}

Request

Response

Errors