Streav
Streav

GET /v1/persons

Retrieves a paginated list of persons.

Parameters
NameLocated inDescriptionRequiredType
NamequeryOptional. Filter persons by name.Nostring
SortByqueryOptional. Sort persons by specified field. Use 'name' for ascending or 'name_desc' for descending order by name. Use 'gender' or 'gender_desc' for sorting by gender. Use 'popularity' or 'popularity_desc' for sorting by popularity. Defaults to ascending order by ID if not specified.Nostring
PagequeryPage number to retrieve. Default is 1.Nointeger
PageSizequeryNumber of records per page. Default is 25.Nointeger
Responses
CodeDescription
200Success

GET /v1/persons/{id}

Retrieves a person by ID.

Parameters
NameLocated inDescriptionRequiredType
idpathThe ID of the person to retrieve.Yesinteger
Responses
CodeDescription
200Success
422Validation error if the input parameters are incorrect.

GET /v1/persons/{imdbId}

Retrieves a person by IMDb ID.

Parameters
NameLocated inDescriptionRequiredType
imdbIdpathThe IMDb ID of the person to retrieve.Yesstring
Responses
CodeDescription
200Success
422Validation error if the input parameters are incorrect.

GET /v1/persons/genders

Retrieves a list of person gender options.

Responses
CodeDescription
200Success