Pokémon API — free mock REST API for testing

Creatures, trainers and a battle simulator. Practice CRUD, Bearer auth, nested resources, pagination and optimistic concurrency.

The Pokémon API holds creatures, trainers and a battle endpoint that resolves a fight from the two teams you send it. The battle result is computed, not stored, which makes it the catalog's clearest example of a POST that is neither a create nor idempotent — and a good target for contract tests over a non-trivial response shape.

Base URL: https://funapi.dev/api/pokemon/v1 · 10 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.

What you can practise here

• Run a battle twice with the same teams and decide whether your test asserts on the outcome or only on the response shape.
• Filter creatures by type and confirm your client handles a type with no members.
• Register a trainer, then create one with a name already taken, and read the conflict.
• Page through the creature list and check the pagination metadata against the number of records you received.

pokemon

eight starters and friends

• GET /pokemon/v1/pokemon — List Pokémon (paginated, filter by type)
• GET /pokemon/v1/pokemon/{id} — Get one Pokémon
• GET /pokemon/v1/pokemon/random — A random Pokémon (wild encounter)
• POST /pokemon/v1/pokemon — Catch a new Pokémon (create) (requires Bearer auth)
• PUT /pokemon/v1/pokemon/{id} — Update a Pokémon (level up, heal, etc.) (requires Bearer auth)
• DELETE /pokemon/v1/pokemon/{id} — Release a Pokémon (requires Bearer auth)

trainers

three trainers, their rosters

• GET /pokemon/v1/trainers — List all trainers
• GET /pokemon/v1/trainers/{id}/pokemon — Get a trainer's roster (nested resource)

battles

simulate a fight, get a random winner

• POST /pokemon/v1/battles — Simulate a battle between two Pokémon (requires Bearer auth)
• GET /pokemon/v1/battles — List battle history (empty until you POST one)

Related APIs

• Friends API — Characters, episodes & quotes from the coffee-house gang.
• Movies API — QA-themed cinema. Sort, filter, rate.
• Harry Potter API — Houses, students & spells from a magic school.
• Star Wars API — Characters, planets & starships from a galaxy far away.

All 39 mock REST APIs