---
title: "List evolution chains"
method: GET
path: "/api/v2/evolution-chain/"
tags: ["evolution"]
---

# List evolution chains

`GET /api/v2/evolution-chain/`

Evolution chains are essentially family trees. They start with the lowest stage within a family and detail evolution conditions for each as well as Pokémon they can evolve into up through the hierarchy.

## Query parameters

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

## Response `200`

- PaginatedEvolutionChainSummaryList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` EvolutionChainSummary[], 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` — 3 info
  - api operation id `api_v2_evolution_chain_list` removed and replaced with `evolution_chain_list`
  - the response property `count` became required for the status `200`
  - the response property `results` became required for the status `200`
- **2025-05-30** `663217b1c9e4` — 1 info
  - api operation id `evolution_chain_list` removed and replaced with `api_v2_evolution_chain_list`
- **2024-05-10** `559f0edc9235` — 1 info
  - added the new optional `query` request parameter `q`
- **2024-02-26** `3dc383577199` — 2 info
  - api tag `evolution` added
  - api tag `evolution-chain` removed

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