Middle-earth API — free mock REST API for testing

Fellowship members, quests and artifacts from a fictional fantasy epic. Practice CRUD, Bearer auth, nested resources, pagination and optimistic concurrency.

The Middle-earth API tracks a fellowship, the quests it is assigned and the artifacts it carries. Members join and leave quests, so it is built around association endpoints — the join-table operations that are easy to write and easy to get wrong when the same member is added twice or removed from a quest they were never on.

Base URL: https://funapi.dev/api/middleearth/v1 · 9 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/middleearth/v1/fellowship — List fellowship members (paginated, filter by race). No token, no signup:

curl -i https://funapi.dev/api/middleearth/v1/fellowship

answers 200 OK with:

{
  "page": 1,
  "pageSize": 3,
  "total": 6,
  "totalPages": 2,
  "data": [
    {
      "id": 1,
      "name": "Aldric Underhill",
      "race": "hobbit",
      "skill": "stealth",
      "_v": 1
    },
    {
      "id": 2,
      "name": "Thoren Oakenshield II",
      "race": "dwarf",
      "skill": "axework",
      "_v": 1
    },
    {
      "id": 3,
      "name": "Elarion Swiftarrow",
      "race": "elf",
      "skill": "archery",
      "_v": 1
    }
  ]
}

Open and run this endpoint

What you can practise here

• Assign the same member to a quest twice and check whether the second call is a conflict or a no-op.
• Remove a member from a quest they never joined and read the status the API chose.
• Update a quest with If-Match after someone else has changed it, for a 412.
• List artifacts filtered by bearer and handle the empty result as success.

fellowship

six companions, six races

• GET /middleearth/v1/fellowship — List fellowship members (paginated, filter by race) · Responds with 200 400 404 Link to this endpoint
• GET /middleearth/v1/fellowship/{id} — Get one fellowship member · Responds with 200 404 Link to this endpoint
• GET /middleearth/v1/fellowship/{id}/artifact — Get the artifact carried by a member (nested resource) · Responds with 200 404 Link to this endpoint
• POST /middleearth/v1/fellowship — Recruit a new member (requires Bearer auth) · Responds with 201 400 401 Link to this endpoint
• PUT /middleearth/v1/fellowship/{id} — Update a fellowship member (requires Bearer auth) · Responds with 200 400 401 404 412 Link to this endpoint
• DELETE /middleearth/v1/fellowship/{id} — Remove a member from the fellowship (requires Bearer auth) · Responds with 204 401 403 404 412 Link to this endpoint

quests

one ring, several detours

• GET /middleearth/v1/quests — List quests, filter by status · Responds with 200 400 Link to this endpoint
• GET /middleearth/v1/quests/random — A random quest · Responds with 200 Link to this endpoint

artifacts

each bound to a bearer

• GET /middleearth/v1/artifacts — List all artifacts · 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 Middle-earth 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 15 October 2026