---
title: "GET /movies/filter"
method: GET
path: "/movies/filter"
tags: ["Movies"]
---

# GET /movies/filter

`GET /movies/filter`

Search movies based on filter parameters

## Query parameters

- `company` number
- `contentRating` number
- `country` string, required
- `genre` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36
- `lang` string, required
- `sort` 'score' | 'firstAired' | 'name'
- `status` 1 | 2 | 3
- `year` number

## Response `200`

response

- object
  - `data` MovieBaseRecord[]
    - `aliases` Alias[]
      - `language` string — A 3-4 character string indicating the language of the alias, as defined in Language.
      - `name` string — A string containing the alias itself.
    - `id` integer
    - `image` string
    - `lastUpdated` string
    - `name` string
    - `nameTranslations` string[]
    - `overviewTranslations` string[]
    - `score` number, double
    - `slug` string
    - `status` Status — status record
      - `id` integer, nullable
      - `keepUpdated` boolean
      - `name` string
      - `recordType` string
    - `runtime` integer, nullable
    - `year` string
  - `status` string

## Other responses

- `400` — Invalid format parameter.
- `401` — Unauthorized

## Changes

- **2024-03-24** `f825d3005872` — 1 breaking
  - the response property `data/items/runtime` became nullable for the status `200`
- **2024-02-08** `8cb67a07c134` — 1 breaking
  - the response property `data/items/status/id` became nullable for the status `200`
- **2022-08-09** `499c304033fa` — 1 info
  - added the optional property `data/items/year` to the response with the `200` status
- **2022-08-09** `925b928e7ab9` — 1 warning
  - removed the optional property `data/items/year` from the response with the `200` status
- **2022-08-09** `fa722c514523` — 1 info
  - added the optional property `data/items/year` to the response with the `200` status

[Full history](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/changes/movies/filter/get.md)

---

[API](https://skmtc.dev/thetvdb/apis/tvdb-api-v4.md) · [All operations](https://skmtc.dev/thetvdb/apis/tvdb-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thetvdb/tvdb-api-v4/revisions/5d7caa274c72/schema)