MovieAPI

Get a list of movies

GET /movies

Get a list of movies

Query parameters

  • category string Required

    Filter movies by category

  • year-min integer

    Filter movies by year greater or equal to year-min

  • year-max integer

    Filter movies by year less or equal to year-max

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • movieId string

      Movie identifier

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[A-Za-z0-9\\-]{1,100}$.

    • title string

      Title of the movie

    • year integer

      Year that the movie is released

    • category string

      Category of the movie

    • budget string

      Budget in free text

    • boxOffice string

      Box office revenue

    • Additional properties are NOT allowed
  • 400 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 401 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 403 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 404 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 422 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 500 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 502 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
  • 504 application/json

    Default error response

    Hide response attribute Show response attribute object
    • message string Required
GET /movies 
curl \
 -X GET http://api.example.com/movies?category=string \
 -H "Authorization: $API_KEY"
Response examples (200) 
[
  {
    "movieId": "string",
    "title": "string",
    "year": 42,
    "category": "string",
    "budget": "string",
    "boxOffice": "string"
  }
]
Response examples (400) 
{
  "message": "Error message"
}
Response examples (401) 
{
  "message": "Error message"
}
Response examples (403) 
{
  "message": "Error message"
}
Response examples (404) 
{
  "message": "Error message"
}
Response examples (422) 
{
  "message": "Error message"
}
Response examples (500) 
{
  "message": "Error message"
}
Response examples (502) 
{
  "message": "Error message"
}
Response examples (504) 
{
  "message": "Error message"
}