---
title: "List moves"
method: GET
path: "/api/v2/move/"
tags: ["moves"]
---

# List moves

`GET /api/v2/move/`

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.

## Query parameters

- `limit` integer
- `offset` integer
- `q` string

## Response `200`

- PaginatedMoveSummaryList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` MoveSummary[]
    - `name` string, required
    - `url` string, uri, required

## Changes

- **2025-05-30** `663217b1c9e4` — 1 info
  - api operation id `move_list` removed and replaced with `api_v2_move_list`
- **2025-02-04** `ad06aa7bf909` — 1 breaking
  - the `results/items/name` response property's maxLength was increased from `100` to `200` for the response status `200`
- **2024-05-10** `559f0edc9235` — 1 info
  - added the new optional `query` request parameter `q`
- **2024-02-26** `3dc383577199` — 2 info
  - api tag `moves` added
  - api tag `move` removed
- **2024-02-24** `c0b00c7eff36` — 2 breaking, 1 warning, 4 info
  - the response property `count` became optional for the status `200`
  - the response property `results` became optional for the status `200`
  - deleted the `query` request parameter `q`
  - the endpoint scheme security `basicAuth` was added to the API
  - …3 more

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