Get a list of characters for a movie

GET /movies/{movieId}/characters

Path parameters

movieId string Required

Identifier of the movie

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

Responses

200 application/json

Successful response
Hide response attributes Show response attributes object
- characterId string
  
  Character identifier
  
  Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[A-Za-z0-9\\-]{1,100}$.
- name string
  
  Name of the character
- playedBy string
  
  Name of the actor playing the character
- role string
  
  Role in the movie, i.e., protagonist or antagonist
- nationality string
  
  Nationality of the character
- 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/{movieId}/characters

curl \
 -X GET http://api.example.com/movies/{movieId}/characters \
 -H "Authorization: $API_KEY"

Response examples (200)

[
  {
    "characterId": "string",
    "name": "string",
    "playedBy": "string",
    "role": "string",
    "nationality": "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"
}