---
title: "Get pokemon encounter"
method: GET
path: "/api/v2/pokemon/{pokemon_id}/encounters"
tags: ["encounters"]
---

# Get pokemon encounter

`GET /api/v2/pokemon/{pokemon_id}/encounters`

Handles Pokemon Encounters as a sub-resource.

## Path parameters

- `pokemon_id` string, required

## Response `200`

- PokemonEncounterResponse[]
  - `location_area` LocationAreaSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `version_details` PokemonEncounterVersionDetailResponse[], required
    - `version` VersionSummary, required
      - `name` string, required
      - `url` string, uri, required
    - `max_chance` integer, required
    - `encounter_details` PokemonEncounterDetailResponse[], required
      - `chance` integer, required
      - `condition_values` EncounterConditionValueSummary[], required
        - `name` string, required
        - `url` string, uri, required
      - `max_level` integer, required
      - `method` EncounterMethodSummary, required
        - `name` string, required
        - `url` string, uri, required
      - `min_level` integer, required

## Changes

- **2026-08-07** `61a1e9796887` — 5 info
  - api operation id `pokemon_encounters_retrieve` removed and replaced with `pokemon_encounters_list`
  - the response required property `items/location_area/url` became read-only for the status `200`
  - the response required property `items/version_details/items/encounter_details/items/condition_values/items/url` became read-only for the status `200`
  - the response required property `items/version_details/items/encounter_details/items/method/url` became read-only for the status `200`
  - …1 more
- **2026-07-17** `dc32de6001cf` — 2 info
  - the endpoint scheme security `basicAuth` was removed from the API
  - the endpoint scheme security `cookieAuth` was removed from the API
- **2026-04-29** `650bc9dd2efe` — 1 info
  - api operation id `api_v2_pokemon_encounters_retrieve` removed and replaced with `pokemon_encounters_retrieve`
- **2025-05-30** `663217b1c9e4` — 1 info
  - api operation id `pokemon_encounters_retrieve` removed and replaced with `api_v2_pokemon_encounters_retrieve`
- **2024-03-04** `dc32bdfac84f` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Full history](https://skmtc.dev/pokeapi/apis/poke-api/changes/api/v2/pokemon/:pokemon_id/encounters/get.md)

---

[API](https://skmtc.dev/pokeapi/apis/poke-api.md) · [All operations](https://skmtc.dev/pokeapi/apis/poke-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pokeapi/poke-api/revisions/05e384460041/schema)