---
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-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`
- **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`/``

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