Movies API — free mock REST API for testing

A catalog of entirely fictional QA-themed films. Practice multi-parameter filtering, sorting, range validation on ratings, and role-based deletes.

The Movies API is a QA-themed catalog you can sort, filter and rate — and the only one with a file-upload endpoint that enforces limits. Posters have a maximum size and an allowed content type, so this is where 413 Payload Too Large and 415 Unsupported Media Type stop being theory.

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

What you can practise here

• Upload a poster over the size limit for a 413, then one with the wrong Content-Type for a 415.
• Combine sort and filter query parameters and check the ordering your client assumes is actually the one returned.
• Rate a film outside the valid range and read the validation error the API sends back.
• Update a movie with a stale ETag to trigger the 412 optimistic-concurrency path.

movies

now showing: Edge Case (2024)

• GET /movies/v1/movies — List movies (filter, sort, paginate)
• GET /movies/v1/movies/{id} — Get one movie
• GET /movies/v1/search — Full-text search movie titles
• GET /movies/v1/search/fuzzy — Typo-tolerant search (fuzzy match, "did you mean")
• POST /movies/v1/movies — Add a movie (requires Bearer auth)
• PUT /movies/v1/movies/{id}/rating — Rate a movie (0–10 inclusive) (requires Bearer auth)
• DELETE /movies/v1/movies/{id} — Remove a movie (requires Bearer auth)
• GET /movies/v1/movies/{id}/similar — Get movies with the same genre (recommendation)

uploads

simulated multipart file uploads

• POST /movies/v1/movies/{id}/poster — Upload a movie poster (simulated multipart file upload) (requires Bearer auth)

Related APIs

• Friends API — Characters, episodes & quotes from the coffee-house gang.
• 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