---
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` object, required
    - `normal` object, required
      - `use_before` object[], nullable, required
        - `name` string, required
        - `url` string, uri, required
      - `use_after` object[], nullable, required
        - `name` string, required
        - `url` string, uri, required
    - `super` object, required
      - `use_before` object[], nullable, required
        - `name` string, required
        - `url` string, uri, required
      - `use_after` object[], 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` object[], required
    - `effect` string, required
    - `short_effect` string, required
    - `language` object, required
      - `name` string, required
      - `url` string, uri, required
  - `effect_changes` object[], required
    - `effect_entries` object[], required
      - `effect` string, required
      - `language` object, required
        - `name` string, required
        - `url` string, uri, required
    - `version_group` object, 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` object[], required
      - `effect` string, required
      - `short_effect` string, required
      - `language` object, 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` object[], required
    - `change` integer, required
    - `stat` object, 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` object[], required
    - `machine` object, required
      - `url` string, uri, required
    - `version_group` object, 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` object[], required
    - `name` string, required
    - `url` string, uri, required

## Changes

- **2026-04-29** `650bc9dd2efe` — 1 info
  - api operation id `api_v2_move_retrieve` removed and replaced with `move_retrieve`
- **2025-05-30** `663217b1c9e4` — 1 info
  - api operation id `move_retrieve` removed and replaced with `api_v2_move_retrieve`
- **2025-02-04** `ad06aa7bf909` — 14 breaking
  - the `contest_type/name` response property's maxLength was increased from `100` to `200` for the response status `200`
  - the `damage_class/name` response property's maxLength was increased from `100` to `200` for the response status `200`
  - the `flavor_text_entries/items/language/name` response property's maxLength was increased from `100` to `200` for the response status `200`
  - the `flavor_text_entries/items/version_group/name` response property's maxLength was increased from `100` to `200` for the response status `200`
  - …10 more
- **2024-05-10** `88897cce8edf` — 1 info
  - for the `path` request parameter `id`, the type/format was generalized from `integer`/`` to `string`/``
- **2024-03-07** `f4f96c8332a3` — 1 warning, 2 info
  - removed the optional property `contest_combos/required` from the response with the `200` status
  - the response property `contest_combos/normal` became required for the status `200`
  - the response property `contest_combos/super` became required for the status `200`

[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/650bc9dd2efe/schema)