Game of Thrones API — free mock REST API for testing

Great houses of Westeros, their nobles, and the dragons of House Targaryen. Practice CRUD, Bearer auth, nested resources, pagination, and a thematic 409 conflict.

The Game of Thrones API is one of the larger surfaces here: houses, nobles, dragons, battles and quotes, with allegiances tying them together. Battles change house standing, so reads taken before a write go stale — making it a practical place to test cache invalidation and optimistic concurrency on something bigger than a two-field record.

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

Example request and response

GET https://funapi.dev/api/got/v1/houses — List all houses. No token, no signup:

curl -i https://funapi.dev/api/got/v1/houses

answers 200 OK with:

{
  "total": 4,
  "data": [
    {
      "id": 1,
      "name": "House Stark",
      "seat": "Winterfell",
      "words": "Winter Is Coming",
      "sigil": "a grey direwolf on white"
    },
    {
      "id": 2,
      "name": "House Targaryen",
      "seat": "Dragonstone",
      "words": "Fire and Blood",
      "sigil": "a red three-headed dragon on black"
    },
    {
      "id": 3,
      "name": "House Lannister",
      "seat": "Casterly Rock",
      "words": "Hear Me Roar",
      "sigil": "a golden lion on crimson"
    },
    {
      "id": 4,
      "name": "House Greyjoy",
      "seat": "Pyke",
      "words": "We Do Not Sow",
      "sigil": "a golden kraken on black"
    }
  ]
}

Open and run this endpoint

What you can practise here

• Fight a battle, then confirm the affected houses' representations changed and your cached copies are invalid.
• Update a house with an If-Match header taken before the battle, for a 412.
• Swear a noble to a house that does not exist and read the 404.
• Page through nobles filtered by house and check the counts add up to the unfiltered total.

houses

four great houses

• GET /got/v1/houses — List all houses · Responds with 200 Link to this endpoint
• GET /got/v1/houses/{id} — Get one house · Responds with 200 404 Link to this endpoint
• GET /got/v1/houses/{id}/nobles — Get all nobles of a house (nested resource) · Responds with 200 404 Link to this endpoint

nobles

not all of them survive

• GET /got/v1/nobles/{id} — Get one noble · Responds with 200 404 Link to this endpoint
• POST /got/v1/nobles — Add a noble to a house (requires Bearer auth) · Responds with 201 400 401 Link to this endpoint
• PUT /got/v1/nobles/{id} — Update a noble (requires Bearer auth) · Responds with 200 400 401 404 412 Link to this endpoint
• POST /got/v1/nobles/{id}/kill — Kill off a noble (409 if already dead) (requires Bearer auth) · Responds with 200 401 403 404 409 Link to this endpoint

dragons

two are still unclaimed

• GET /got/v1/dragons — List dragons, filter by size · Responds with 200 400 Link to this endpoint
• GET /got/v1/dragons/random — A random dragon · Responds with 200 Link to this endpoint

battles

Westeros conflict simulator

• POST /got/v1/battles — Simulate a battle between two houses (requires Bearer auth) · Responds with 201 400 409 Link to this endpoint
• GET /got/v1/battles/{id} — Get a battle result · Responds with 200 404 Link to this endpoint

quotes

memorable lines

• GET /got/v1/quotes/random — Get a random Westeros quote · Responds with 200 Link to this endpoint

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

Use this response elsewhere

• JSON to TypeScript on fundata.dev — an interface for this response
• JSON to Zod on fundata.dev — a runtime validator for it
• mock API data on fundata.dev — thousands of records of the same shape for your own fixtures

Unofficial and fan-made. The Game of Thrones API is a practice API that borrows a theme; it is not affiliated with, sponsored or endorsed by the owners of the names it references, which belong to them. Every record it returns is test data for exercising HTTP behaviour, not an authoritative source on the subject.

Last updated 2 October 2026