List Pokémon encounter locations

1 parameter

pokemon_idstringrequired

The Pokémon identifier to retrieve encounters for. Must contain digits only.

1 status code

200Returns an array of encounter records, each containing a location area and version-specific encounter details.

location_areaobjectrequired

version_detailsarray<object>required

Error handling

The pokemon_id path parameter must contain digits only, as required by its pattern. Supply the identifier of the Pokémon whose encounter locations you want to list.

import { Client } from "pokéapi";

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

const result = await client.encounters.list({ pokemonId: "3fa85f64-5717-4562-b3fc-2c963f66afa6" });

[
  {
    "location_area": {
      "name": "Example Name",
      "url": "https://example.com"
    },
    "version_details": [
      {
        "version": {
          "name": "Example Name",
          "url": "https://example.com"
        },
        "max_chance": 1,
        "encounter_details": [
          {
            "chance": 1,
            "condition_values": [
              null
            ],
            "max_level": 1,
            "method": {
              "name": null,
              "url": null
            },
            "min_level": 1
          }
        ]
      }
    ]
  }
]

Request

Response

Errors