Friends API — free mock REST API for testing

Characters, episodes and quotes from the sitcom universe. Practice CRUD, Bearer auth, pagination, filtering and every error code — no setup needed.

The Friends API models a sitcom archive: six main characters with jobs and catchphrases, ten episodes, and a quote collection. It is the catalog's introduction to API versioning — the v1 character list is deliberately marked deprecated and answers with Deprecation, Sunset and Link headers pointing at v2, so you can practise the one migration path most public APIs eventually force on their consumers.

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

What you can practise here

• Read the Deprecation and Sunset headers on GET /characters, then follow the Link header to the v2 successor.
• Send an unknown query parameter to the strict v1 list endpoint and watch it answer 400 rather than ignoring it.
• Create a character with an Idempotency-Key, replay the exact request, and confirm you get the original 201 body back instead of a duplicate.
• Ask for a page beyond the end of the collection and handle the 404 your pagination code probably assumes never happens.

characters

the six of them, and more

• GET /friends/v1/characters — List all characters (paginated) — v1, deprecated
• GET /friends/v1/characters/{id} — Get one character
• POST /friends/v1/characters — Create a character (requires Bearer auth)
• POST /friends/v1/characters/bulk — Batch-create characters (array body, per-item validation) (requires Bearer auth)
• PUT /friends/v1/characters/{id} — Update a character (requires Bearer auth)
• POST /friends/v1/characters/bulk-delete — Bulk-delete characters by id (partial success supported) (requires Bearer auth)
• DELETE /friends/v1/characters/{id} — Delete a character (requires Bearer auth)
• GET /friends/v1/characters/{id}/quotes — Get a character's quotes (nested resource)
• GET /friends/v1/friends/v2/characters — List characters — v2 (breaking change: job → occupation, re-wrapped)
• GET /friends/v1/friends/version — Discover supported API versions
• GET /friends/v1/friends/characters — Content-negotiated version via Accept header (406 if unsupported)

episodes

ten fan favorites

• GET /friends/v1/episodes — List episodes, filter by season

quotes

could this API BE any more quotable?

• GET /friends/v1/quotes/random — A random quote

graphql

one POST endpoint, query-shaped

• POST /friends/v1/graphql — Run a query or mutation over character data

Related APIs

• 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.
• Sherlock Holmes API — Cases, suspects & clues from Baker Street.

All 39 mock REST APIs