---
title: "Get move"
method: GET
path: "/api/v2/move/{id}/"
tags: ["moves"]
---

# Get move

`GET /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 outside of battle as well, usually for the purpose of removing obstacles or exploring new areas.

## Path parameters

- `id` string, required

## Response `200`

- MoveDetail
  - `id` integer, required
  - `name` string, required
  - `accuracy` integer, nullable
  - `effect_chance` integer, required
  - `pp` integer, nullable
  - `priority` integer, nullable
  - `power` integer, nullable
  - `contest_combos` MoveCombos, required
    - `normal` MoveComboUsage, required
      - `use_before` MoveSummary[], nullable, required
        - `name` string, required
        - `url` string, uri, required
      - `use_after` MoveSummary[], nullable, required
        - `name` string, required
        - `url` string, uri, required
    - `super` MoveComboUsage, required
      - `use_before` MoveSummary[], nullable, required
        - `name` string, required
        - `url` string, uri, required
      - `use_after` MoveSummary[], nullable, required
        - `name` string, required
        - `url` string, uri, required
  - `contest_type` ContestTypeSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `contest_effect` ContestEffectSummary, required
    - `url` string, uri, required
  - `damage_class` MoveDamageClassSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `effect_entries` MoveEffectEffectText[], required
    - `effect` string, required
    - `short_effect` string, required
    - `language` LanguageSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `effect_changes` MoveEffectChange[], required
    - `version_group` VersionGroupSummary, required
      - `name` string, required
      - `url` string, uri, required
    - `effect_entries` MoveEffectChangeEffectText[], required
      - `effect` string, required
      - `language` LanguageSummary, required
        - `name` string, required
        - `url` string, uri, required
  - `generation` GenerationSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `meta` MoveMeta, required
    - `ailment` MoveMetaAilmentSummary, required
      - `name` string, required
      - `url` string, uri, required
    - `category` MoveMetaCategorySummary, required
      - `name` string, required
      - `url` string, uri, required
    - `min_hits` integer, nullable
    - `max_hits` integer, nullable
    - `min_turns` integer, nullable
    - `max_turns` integer, nullable
    - `drain` integer, nullable
    - `healing` integer, nullable
    - `crit_rate` integer, nullable
    - `ailment_chance` integer, nullable
    - `flinch_chance` integer, nullable
    - `stat_chance` integer, nullable
  - `names` MoveName[], required
    - `name` string, required
    - `language` LanguageSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `past_values` MoveChange[], required
    - `accuracy` integer, nullable
    - `power` integer, nullable
    - `pp` integer, nullable
    - `effect_chance` integer, required
    - `effect_entries` MoveEffectEffectText[], required
      - `effect` string, required
      - `short_effect` string, required
      - `language` LanguageSummary, required
        - `name` string, required
        - `url` string, uri, required
    - `type` TypeSummary, required
      - `name` string, required
      - `url` string, uri, required
    - `version_group` VersionGroupSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `stat_changes` MoveMetaStatChange[], required
    - `change` integer, required
    - `stat` StatSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `super_contest_effect` SuperContestEffectSummary, required
    - `url` string, uri, required
  - `target` MoveTargetSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `type` TypeSummary, required
    - `name` string, required
    - `url` string, uri, required
  - `machines` ItemMachine[], required
    - `machine` MachineSummary, required
      - `url` string, uri, required
    - `version_group` VersionGroupSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `flavor_text_entries` MoveFlavorText[], required
    - `flavor_text` string, required
    - `language` LanguageSummary, required
      - `name` string, required
      - `url` string, uri, required
    - `version_group` VersionGroupSummary, required
      - `name` string, required
      - `url` string, uri, required
  - `learned_by_pokemon` PokemonSummary[], required
    - `name` string, required
    - `url` string, uri, required

## Changes

- **2026-08-08** `05e384460041` — 1 breaking, 1 info
  - added `#/components/schemas/MoveCombos` to the `contest_combos` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/_MoveCombosDetail` from the `contest_combos` response property `oneOf` list for the response status `200`
- **2026-08-08** `0bfa5b75c167` — 1 breaking, 1 info
  - removed the required property `machines/items/item` from the response with the `200` status
  - added the required property `machines/items/machine` to the response with the `200` status
- **2026-08-08** `fe58d471586f` — 6 breaking, 9 info
  - added `#/components/schemas/_MoveCombosDetail, subschema #2` to the `contest_combos` response property `oneOf` list for the response status `200`
  - the `contest_combos` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `stat_changes/items/change` response's property type/format changed from `integer`/`int32` to `integer`/`` for status `200`
  - removed the required property `contest_combos/normal` from the response with the `200` status
  - …11 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_move_retrieve` removed and replaced with `move_retrieve`

[Full history](https://skmtc.dev/pokeapi/apis/poke-api/changes/api/v2/move/:id/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)