Radarr

App · 17 actions

Run your movie collection in Radarr from workflows: add movies from requests, forms or watchlists, look up and list movies, search, refresh, tag and delete them, get upcoming releases for a digest, and see missing movies, the download queue, history, health and disk space. Start a workflow when a movie is downloaded, grabbed or added, or Radarr reports a health issue.

Actions

ActionWhat it does
Add movieAdd a movie to Radarr by its title (and year), TMDB ID or IMDb ID, with a quality profile, and have Radarr search for it.
Add tags to movieGive a movie one or more tags, making any Radarr doesn't have.
Delete movieRemove a movie from Radarr.
Get disk spaceGet the free space on every disk Radarr can see and in its root folders, such as to warn before the library fills up.
Get healthGet the warnings and errors Radarr's health check reports (an indexer or download client it can't reach, a missing root folder, an update), and its version.
Get movieGet a movie in Radarr's library: whether it's downloaded and its file's quality and size, whether it's monitored, its release dates and its tags.
Get upcoming releasesList the movies in Radarr that open in cinemas or come out digitally or on disc in the next few days, soonest first, as Radarr's Calendar shows them.
List historyList what Radarr did, newest first: releases grabbed, downloads imported or failed, files deleted or renamed, for a movie or all, such as this week's downloads.
List missing moviesList the monitored movies Radarr has no file of yet, as Wanted > Missing shows them, by title.
List moviesList the movies in Radarr's library, by words in the title, downloaded or missing, monitored, or tag, with their status and file.
List queueList the downloads in Radarr's queue with their progress and time left, and which are stuck (a warning, an error, or an import Radarr can't finish) and why.
Look up moviesFind movies on TMDB through Radarr by title, TMDB ID or IMDb ID, with their year, release dates and whether they're in the library, such as to pick one before adding it.
Refresh movieHave Radarr update a movie's details from TMDB and rescan its folder for files, such as after adding a file by hand; or refresh every movie.
Remove from queueRemove a download from Radarr's queue, such as a stuck one, and from the download client; optionally blocklist the release so Radarr searches for another.
Remove tags from movieTake one or more tags off a movie.
Search for movieHave Radarr search its indexers for a movie now and grab the best release its quality profile allows, as its Search button does; or search for every missing movie.
Update movieChange whether Radarr monitors a movie, its quality profile or its minimum availability, such as to stop looking once it's downloaded.

Add movie

Add a movie to Radarr by its title (and year), TMDB ID or IMDb ID, with a quality profile, and have Radarr search for it. One already in the library is returned as it is.

Inputs

Titletitletext
The movie's title, such as The Matrix. A TMDB or IMDb link works too. Leave blank when giving a TMDB or IMDb ID.
Yearyearnumber
The year it came out, to pick the right one of movies with the same title.From 1870 to 2200.
TMDB IDtmdb_idnumber
The movie's TMDB ID, such as 603 (the number in its themoviedb.org address). Used instead of the title.At least 1.
IMDb IDimdb_idtext
The movie's IMDb ID, such as tt0133093. Used instead of the title.
Quality profilequality_profiletextRequired
The quality profile, which decides what quality Radarr downloads, such as HD-1080p.
Root folderroot_foldertext
The folder to put it in, such as /movies. Leave blank when Radarr has only one.
Minimum availabilityminimum_availabilitytext
When Radarr starts looking for it: once it's announced, in cinemas, or released (on disc or digitally).One of: announced, inCinemas (In Cinemas), released. Default: released.
Monitoredmonitoredtrue/false
Have Radarr look for it and its upgrades. Off adds it without downloading anything.Default: true.
Search on addsearch_on_addtrue/false
Search for it straight away, rather than waiting for a new release to turn up.Default: true.
Tagstagstext
Tag names to give it, separated by commas, such as kids. Tags Radarr doesn't have are made.

Outputs

addedtext
When it was added to Radarr (UTC)
already_addedtrue/false
Whether it was already in the library, left as it was
availabletrue/false
Whether it has reached its minimum availability
certificationtext
Its rating, such as PG-13
digital_releasetext
When it came out digitally (UTC)
downloadedtrue/false
Whether Radarr has a file of it
fileobject
Its file, when it has one
genreslist
Its genres
idnumber
The movie's ID in Radarr, for other Radarr steps
imdb_idtext
Its IMDb ID, such as tt0133093
in_cinemastext
When it opened in cinemas (UTC)
linktext
A link to it in Radarr
minimum_availabilitytext
When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false
Whether Radarr looks for it and its upgrades
overviewtext
What it's about
pathtext
Its folder on Radarr's server
physical_releasetext
When it came out on disc (UTC)
poster_urltext
A link to its poster
quality_profiletext
Its quality profile's name
quality_profile_idnumber
Its quality profile's ID
ratingnumber
Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext
The root folder it's in
runtime_minutesnumber
How long it runs, in minutes
searchingtrue/false
Whether Radarr started searching for it
size_on_disknumber
How many bytes its files take
statustext
announced, inCinemas, released, tba or deleted
studiotext
Its studio
tagslist
Its tags' names
titletext
Its title
tmdb_idnumber
Its TMDB ID
tmdb_linktext
A link to it on TMDB
yearnumber
Its year
Example output
{
  "added": "2026-11-08T20:02:44Z",
  "already_added": false,
  "available": true,
  "certification": "R",
  "digital_release": "2001-03-19T00:00:00Z",
  "downloaded": false,
  "file": {
    "added": "",
    "edition": "",
    "id": 0,
    "path": "",
    "quality": "",
    "relative_path": "",
    "release_group": "",
    "size": 0,
    "size_text": ""
  },
  "genres": [
    "Action",
    "Science Fiction"
  ],
  "id": 1,
  "imdb_id": "tt0133093",
  "in_cinemas": "1999-03-31T00:00:00Z",
  "link": "http://192.168.1.20:7878/movie/603",
  "minimum_availability": "released",
  "monitored": true,
  "overview": "A computer hacker learns the true nature of his reality.",
  "path": "/movies/The Matrix (1999)",
  "physical_release": "1999-11-25T00:00:00Z",
  "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "rating": 8.7,
  "root_folder": "/movies",
  "runtime_minutes": 136,
  "searching": true,
  "size_on_disk": 0,
  "status": "released",
  "studio": "Village Roadshow Pictures",
  "tags": [],
  "title": "The Matrix",
  "tmdb_id": 603,
  "tmdb_link": "https://www.themoviedb.org/movie/603",
  "year": 1999
}

Add tags to movie

Give a movie one or more tags, making any Radarr doesn't have. Tags it already has stay.

Inputs

MoviemovietextRequired
The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
TagstagstextRequired
Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.

Outputs

addedtext
When it was added to Radarr (UTC)
availabletrue/false
Whether it has reached its minimum availability
certificationtext
Its rating, such as PG-13
changed_tagslist
The tags added (or removed) by this step
digital_releasetext
When it came out digitally (UTC)
downloadedtrue/false
Whether Radarr has a file of it
fileobject
Its file, when it has one
genreslist
Its genres
idnumber
The movie's ID in Radarr, for other Radarr steps
imdb_idtext
Its IMDb ID, such as tt0133093
in_cinemastext
When it opened in cinemas (UTC)
linktext
A link to it in Radarr
minimum_availabilitytext
When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false
Whether Radarr looks for it and its upgrades
overviewtext
What it's about
pathtext
Its folder on Radarr's server
physical_releasetext
When it came out on disc (UTC)
poster_urltext
A link to its poster
quality_profiletext
Its quality profile's name
quality_profile_idnumber
Its quality profile's ID
ratingnumber
Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext
The root folder it's in
runtime_minutesnumber
How long it runs, in minutes
size_on_disknumber
How many bytes its files take
statustext
announced, inCinemas, released, tba or deleted
studiotext
Its studio
tagslist
Its tags' names
titletext
Its title
tmdb_idnumber
Its TMDB ID
tmdb_linktext
A link to it on TMDB
yearnumber
Its year
Example output
{
  "added": "2026-11-08T20:02:44Z",
  "available": true,
  "certification": "R",
  "changed_tags": [
    "kids"
  ],
  "digital_release": "2001-03-19T00:00:00Z",
  "downloaded": true,
  "file": {
    "added": "2026-11-08T21:14:03Z",
    "edition": "",
    "id": 7,
    "path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
    "quality": "Bluray-1080p",
    "relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
    "release_group": "SPARKS",
    "size": 8804682752,
    "size_text": "8.2 GB"
  },
  "genres": [
    "Action",
    "Science Fiction"
  ],
  "id": 1,
  "imdb_id": "tt0133093",
  "in_cinemas": "1999-03-31T00:00:00Z",
  "link": "http://192.168.1.20:7878/movie/603",
  "minimum_availability": "released",
  "monitored": true,
  "overview": "A computer hacker learns the true nature of his reality.",
  "path": "/movies/The Matrix (1999)",
  "physical_release": "1999-11-25T00:00:00Z",
  "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "rating": 8.7,
  "root_folder": "/movies",
  "runtime_minutes": 136,
  "size_on_disk": 8804682752,
  "status": "released",
  "studio": "Village Roadshow Pictures",
  "tags": [
    "family",
    "kids"
  ],
  "title": "The Matrix",
  "tmdb_id": 603,
  "tmdb_link": "https://www.themoviedb.org/movie/603",
  "year": 1999
}

Delete movie

Remove a movie from Radarr. Its files stay on disk unless Delete files is on, which deletes them for good and can't be undone.

Inputs

MoviemovietextRequired
The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
Delete filesdelete_filestrue/false
Also delete the movie's folder and files from disk. This can't be undone.Default: false.
Exclude from import listsadd_exclusiontrue/false
Keep Radarr's import lists from adding it again.Default: false.

Outputs

deletedtrue/false
True: it's out of Radarr
excludedtrue/false
Whether it's kept out of import lists
files_deletedtrue/false
Whether its files were deleted from disk
idnumber
The movie's ID in Radarr, which is gone now
titletext
Its title
tmdb_idnumber
Its TMDB ID
yearnumber
Its year
Example output
{
  "deleted": true,
  "excluded": false,
  "files_deleted": false,
  "id": 1,
  "title": "The Matrix",
  "tmdb_id": 603,
  "year": 1999
}

Get disk space

Get the free space on every disk Radarr can see and in its root folders, such as to warn before the library fills up.

Inputs

None.

Outputs

countnumber
How many disks Radarr reports
diskslist
Every disk Radarr can see
lowest_percent_freenumber
The least free space on any disk, in percent
root_folderslist
The root folders movies go in
Example output
{
  "count": 1,
  "disks": [
    {
      "free": "1.2 TB",
      "free_bytes": 1319413953331,
      "label": "",
      "path": "/movies",
      "percent_free": 30.0,
      "total": "4.0 TB",
      "total_bytes": 4398046511104
    }
  ],
  "lowest_percent_free": 30.0,
  "root_folders": [
    {
      "accessible": true,
      "free": "1.2 TB",
      "free_bytes": 1319413953331,
      "path": "/movies",
      "unmapped_folders": 0
    }
  ]
}

Get health

Get the warnings and errors Radarr's health check reports (an indexer or download client it can't reach, a missing root folder, an update), and its version.

Inputs

None.

Outputs

errorsnumber
How many errors
healthytrue/false
True when Radarr reports no warnings or errors
instance_nametext
Radarr's name, as set under Settings > General
issueslist
What Radarr's health check reports
linktext
A link to Radarr's System > Status page
startedtext
When Radarr last started (UTC)
versiontext
Radarr's version
warningsnumber
How many warnings
Example output
{
  "errors": 0,
  "healthy": false,
  "instance_name": "Radarr",
  "issues": [
    {
      "message": "Unable to communicate with qBittorrent.",
      "source": "DownloadClientCheck",
      "type": "warning",
      "wiki_url": "https://wiki.servarr.com/radarr/system#download-clients"
    }
  ],
  "link": "http://192.168.1.20:7878/system/status",
  "started": "2026-11-09T18:59:48Z",
  "version": "6.4.4.10685",
  "warnings": 1
}

Get movie

Get a movie in Radarr's library: whether it's downloaded and its file's quality and size, whether it's monitored, its release dates and its tags.

Inputs

MoviemovietextRequired
The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.

Outputs

addedtext
When it was added to Radarr (UTC)
availabletrue/false
Whether it has reached its minimum availability
certificationtext
Its rating, such as PG-13
digital_releasetext
When it came out digitally (UTC)
downloadedtrue/false
Whether Radarr has a file of it
fileobject
Its file, when it has one
genreslist
Its genres
idnumber
The movie's ID in Radarr, for other Radarr steps
imdb_idtext
Its IMDb ID, such as tt0133093
in_cinemastext
When it opened in cinemas (UTC)
linktext
A link to it in Radarr
minimum_availabilitytext
When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false
Whether Radarr looks for it and its upgrades
overviewtext
What it's about
pathtext
Its folder on Radarr's server
physical_releasetext
When it came out on disc (UTC)
poster_urltext
A link to its poster
quality_profiletext
Its quality profile's name
quality_profile_idnumber
Its quality profile's ID
ratingnumber
Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext
The root folder it's in
runtime_minutesnumber
How long it runs, in minutes
size_on_disknumber
How many bytes its files take
statustext
announced, inCinemas, released, tba or deleted
studiotext
Its studio
tagslist
Its tags' names
titletext
Its title
tmdb_idnumber
Its TMDB ID
tmdb_linktext
A link to it on TMDB
yearnumber
Its year
Example output
{
  "added": "2026-11-08T20:02:44Z",
  "available": true,
  "certification": "R",
  "digital_release": "2001-03-19T00:00:00Z",
  "downloaded": true,
  "file": {
    "added": "2026-11-08T21:14:03Z",
    "edition": "",
    "id": 7,
    "path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
    "quality": "Bluray-1080p",
    "relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
    "release_group": "SPARKS",
    "size": 8804682752,
    "size_text": "8.2 GB"
  },
  "genres": [
    "Action",
    "Science Fiction"
  ],
  "id": 1,
  "imdb_id": "tt0133093",
  "in_cinemas": "1999-03-31T00:00:00Z",
  "link": "http://192.168.1.20:7878/movie/603",
  "minimum_availability": "released",
  "monitored": true,
  "overview": "A computer hacker learns the true nature of his reality.",
  "path": "/movies/The Matrix (1999)",
  "physical_release": "1999-11-25T00:00:00Z",
  "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "rating": 8.7,
  "root_folder": "/movies",
  "runtime_minutes": 136,
  "size_on_disk": 8804682752,
  "status": "released",
  "studio": "Village Roadshow Pictures",
  "tags": [
    "family"
  ],
  "title": "The Matrix",
  "tmdb_id": 603,
  "tmdb_link": "https://www.themoviedb.org/movie/603",
  "year": 1999
}

Get upcoming releases

List the movies in Radarr that open in cinemas or come out digitally or on disc in the next few days, soonest first, as Radarr's Calendar shows them. For a weekly digest.

Inputs

Days aheaddaysnumber
How many days ahead to look. Defaults to 7.From 1 to 365.
Include unmonitoredinclude_unmonitoredtrue/false
Also list movies Radarr isn't monitoring.Default: false.

Outputs

countnumber
How many movies have a release then
endtext
To when (UTC)
movieslist
The movies, soonest release first
starttext
From when (UTC)
Example output
{
  "count": 1,
  "end": "2026-12-08T09:00:00Z",
  "movies": [
    {
      "added": "2026-11-08T20:02:44Z",
      "available": false,
      "certification": "R",
      "digital_release": "",
      "downloaded": false,
      "file": {
        "added": "",
        "edition": "",
        "id": 0,
        "path": "",
        "quality": "",
        "relative_path": "",
        "release_group": "",
        "size": 0,
        "size_text": ""
      },
      "genres": [
        "Action",
        "Science Fiction"
      ],
      "id": 3,
      "imdb_id": "tt21357150",
      "in_cinemas": "2026-12-04T00:00:00Z",
      "link": "http://192.168.1.20:7878/movie/1003596",
      "minimum_availability": "released",
      "monitored": true,
      "next_release": "In cinemas",
      "next_release_date": "2026-12-04T00:00:00Z",
      "overview": "A computer hacker learns the true nature of his reality.",
      "path": "/movies/The Matrix (1999)",
      "physical_release": "",
      "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
      "quality_profile": "HD-1080p",
      "quality_profile_id": 4,
      "rating": 8.7,
      "releases": [
        {
          "date": "2026-12-04T00:00:00Z",
          "label": "In cinemas",
          "type": "in_cinemas"
        }
      ],
      "root_folder": "/movies",
      "runtime_minutes": 136,
      "size_on_disk": 0,
      "status": "announced",
      "studio": "Village Roadshow Pictures",
      "tags": [
        "family"
      ],
      "title": "Avengers: Doomsday",
      "tmdb_id": 1003596,
      "tmdb_link": "https://www.themoviedb.org/movie/1003596",
      "year": 2026
    }
  ],
  "start": "2026-12-01T09:00:00Z"
}

List history

List what Radarr did, newest first: releases grabbed, downloads imported or failed, files deleted or renamed, for a movie or all, such as this week's downloads.

Inputs

Eventeventtext
Only events of this kind.One of: any, grabbed (Grabbed (sent to the download client)), downloaded (Downloaded and imported), failed (Download failed), file_deleted (File deleted), folder_imported (Imported from the movie's folder), renamed (File renamed), ignored (Download ignored). Default: any.
Moviemovietext
Only events for this movie.
Within the last (days)daysnumber
Only events from the last this many days.From 1 to 3650.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 500.

Outputs

countnumber
How many are listed
eventslist
The events, newest first
Example output
{
  "count": 1,
  "events": [
    {
      "date": "2026-11-09T19:12:10Z",
      "download_client": "qBittorrent",
      "download_id": "0123456789ABCDEF0123456789ABCDEF01234567",
      "event": "downloaded",
      "id": 42,
      "imdb_id": "tt0133093",
      "imported_path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv",
      "indexer": "",
      "link": "http://192.168.1.20:7878/movie/603",
      "movie_id": 1,
      "movie_title": "The Matrix",
      "movie_year": 1999,
      "quality": "Bluray-1080p",
      "reason": "",
      "release_title": "The.Matrix.1999.1080p.BluRay.x264-GROUP",
      "size": 0,
      "tmdb_id": 603
    }
  ]
}

List missing movies

List the monitored movies Radarr has no file of yet, as Wanted > Missing shows them, by title.

Inputs

Only releasedonly_availabletrue/false
Only movies that have reached their minimum availability, so Radarr could download them now. Off includes those not out yet.Default: true.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 500.

Outputs

countnumber
How many are listed
monitored_missingnumber
How many monitored movies have no file, released or not
movieslist
The missing movies, by title
Example output
{
  "count": 1,
  "monitored_missing": 3,
  "movies": [
    {
      "added": "2026-11-08T20:02:44Z",
      "available": true,
      "certification": "R",
      "digital_release": "2001-03-19T00:00:00Z",
      "downloaded": false,
      "file": {
        "added": "",
        "edition": "",
        "id": 0,
        "path": "",
        "quality": "",
        "relative_path": "",
        "release_group": "",
        "size": 0,
        "size_text": ""
      },
      "genres": [
        "Action",
        "Science Fiction"
      ],
      "id": 1,
      "imdb_id": "tt0133093",
      "in_cinemas": "1999-03-31T00:00:00Z",
      "link": "http://192.168.1.20:7878/movie/603",
      "minimum_availability": "released",
      "monitored": true,
      "overview": "A computer hacker learns the true nature of his reality.",
      "path": "/movies/The Matrix (1999)",
      "physical_release": "1999-11-25T00:00:00Z",
      "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
      "quality_profile": "HD-1080p",
      "quality_profile_id": 4,
      "rating": 8.7,
      "root_folder": "/movies",
      "runtime_minutes": 136,
      "size_on_disk": 0,
      "status": "released",
      "studio": "Village Roadshow Pictures",
      "tags": [
        "family"
      ],
      "title": "The Matrix",
      "tmdb_id": 603,
      "tmdb_link": "https://www.themoviedb.org/movie/603",
      "year": 1999
    }
  ]
}

List movies

List the movies in Radarr's library, by words in the title, downloaded or missing, monitored, or tag, with their status and file.

Inputs

Searchsearchtext
Only movies with these words in the title.
Downloadeddownloadedtext
Only movies Radarr has a file of, or only those it hasn't.One of: any, downloaded (Downloaded (has a file)), missing (Missing (no file yet)). Default: any.
Monitoredmonitoredtext
Only monitored movies, or only those that aren't.One of: any, monitored, unmonitored (Not monitored). Default: any.
Tagtagtext
Only movies with this tag.
Sort bysorttext
The order to list them in.One of: title, added (Newest added first), year (Newest year first). Default: title.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 500.

Outputs

countnumber
How many are listed
movieslist
The movies
totalnumber
How many match in all
Example output
{
  "count": 1,
  "movies": [
    {
      "added": "2026-11-08T20:02:44Z",
      "available": true,
      "certification": "R",
      "digital_release": "2001-03-19T00:00:00Z",
      "downloaded": true,
      "file": {
        "added": "2026-11-08T21:14:03Z",
        "edition": "",
        "id": 7,
        "path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
        "quality": "Bluray-1080p",
        "relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
        "release_group": "SPARKS",
        "size": 8804682752,
        "size_text": "8.2 GB"
      },
      "genres": [
        "Action",
        "Science Fiction"
      ],
      "id": 1,
      "imdb_id": "tt0133093",
      "in_cinemas": "1999-03-31T00:00:00Z",
      "link": "http://192.168.1.20:7878/movie/603",
      "minimum_availability": "released",
      "monitored": true,
      "overview": "A computer hacker learns the true nature of his reality.",
      "path": "/movies/The Matrix (1999)",
      "physical_release": "1999-11-25T00:00:00Z",
      "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
      "quality_profile": "HD-1080p",
      "quality_profile_id": 4,
      "rating": 8.7,
      "root_folder": "/movies",
      "runtime_minutes": 136,
      "size_on_disk": 8804682752,
      "status": "released",
      "studio": "Village Roadshow Pictures",
      "tags": [
        "family"
      ],
      "title": "The Matrix",
      "tmdb_id": 603,
      "tmdb_link": "https://www.themoviedb.org/movie/603",
      "year": 1999
    }
  ],
  "total": 1
}

List queue

List the downloads in Radarr's queue with their progress and time left, and which are stuck (a warning, an error, or an import Radarr can't finish) and why.

Inputs

Only stuck downloadsonly_stucktrue/false
Only downloads that need a person.Default: false.
How manylimitnumber
The most to list. Defaults to 50.From 1 to 500.

Outputs

countnumber
How many are listed
itemslist
The downloads
stucknumber
How many need a person
totalnumber
How many downloads are in the queue (that match)
Example output
{
  "count": 1,
  "items": [
    {
      "added": "2026-11-09T19:03:50Z",
      "download_client": "qBittorrent",
      "download_id": "0123456789ABCDEF0123456789ABCDEF01234567",
      "estimated_completion": "2026-11-09T19:06:45Z",
      "health": "warning",
      "id": 1506557212,
      "indexer": "Example Indexer",
      "messages": [
        "The.Matrix.1999.1080p.BluRay.x264-GROUP.mkv: Not an upgrade"
      ],
      "movie_id": 1,
      "movie_title": "The Matrix",
      "movie_year": 1999,
      "output_path": "/downloads/The.Matrix.1999.1080p.BluRay.x264-GROUP",
      "progress_percent": 100.0,
      "protocol": "torrent",
      "quality": "Bluray-1080p",
      "size": 8804682752,
      "size_left": 0,
      "state": "importBlocked",
      "status": "completed",
      "stuck": true,
      "time_left": "00:00:00",
      "title": "The.Matrix.1999.1080p.BluRay.x264-GROUP"
    }
  ],
  "stuck": 1,
  "total": 1
}

Look up movies

Find movies on TMDB through Radarr by title, TMDB ID or IMDb ID, with their year, release dates and whether they're in the library, such as to pick one before adding it.

Inputs

Title or IDtermtextRequired
A title, such as The Matrix, or tmdb:603, or an IMDb ID such as tt0133093.
How manylimitnumber
The most to list. Defaults to 10.From 1 to 50.

Outputs

countnumber
How many are listed
movieslist
The movies found, best match first
termtext
What was looked up
totalnumber
How many were found
Example output
{
  "count": 1,
  "movies": [
    {
      "digital_release": "2001-03-19T00:00:00Z",
      "genres": [
        "Action",
        "Science Fiction"
      ],
      "imdb_id": "tt0133093",
      "in_cinemas": "1999-03-31T00:00:00Z",
      "in_library": false,
      "link": "",
      "movie_id": 0,
      "overview": "A computer hacker learns the true nature of his reality.",
      "physical_release": "1999-11-25T00:00:00Z",
      "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
      "rating": 8.7,
      "runtime_minutes": 136,
      "status": "released",
      "title": "The Matrix",
      "tmdb_id": 603,
      "tmdb_link": "https://www.themoviedb.org/movie/603",
      "year": 1999
    }
  ],
  "term": "The Matrix",
  "total": 1
}

Refresh movie

Have Radarr update a movie's details from TMDB and rescan its folder for files, such as after adding a file by hand; or refresh every movie.

Inputs

Moviemovietext
The movie to refresh. Leave blank to refresh every movie, which can take a while.

Outputs

commandtext
The task, such as Movies Search
command_idnumber
Radarr's ID for the task
endedtext
When it finished (UTC)
finishedtrue/false
Whether it finished while the step waited
messagetext
What Radarr said when it finished
movie_idnumber
The movie's ID in Radarr; 0 for every movie
movie_titletext
The movie's title; blank for every movie
queuedtext
When it was queued (UTC)
startedtext
When it started (UTC)
statustext
queued, started or completed
Example output
{
  "command": "Refresh Movie",
  "command_id": 813,
  "ended": "2026-11-09T19:09:51Z",
  "finished": true,
  "message": "Completed",
  "movie_id": 1,
  "movie_title": "The Matrix",
  "queued": "2026-11-09T19:09:47Z",
  "started": "2026-11-09T19:09:47Z",
  "status": "completed"
}

Remove from queue

Remove a download from Radarr's queue, such as a stuck one, and from the download client; optionally blocklist the release so Radarr searches for another.

Inputs

DownloaditemtextRequired
The download: its ID in the queue (from List queue) or its release name.
Remove from download clientremove_from_clienttrue/false
Also remove it, and what it downloaded, from the download client. Off leaves it there and Radarr stops tracking it.Default: true.
Blocklist releaseblocklisttrue/false
Never grab this release again, and search for another.Default: false.

Outputs

blocklistedtrue/false
Whether the release was blocklisted
idnumber
The download's ID in the queue
movie_idnumber
The movie's ID in Radarr
movie_titletext
The movie's title
removedtrue/false
True: it's out of the queue
removed_from_clienttrue/false
Whether it was removed from the download client too
titletext
The release's name
Example output
{
  "blocklisted": false,
  "id": 1506557212,
  "movie_id": 1,
  "movie_title": "The Matrix",
  "removed": true,
  "removed_from_client": true,
  "title": "The.Matrix.1999.1080p.BluRay.x264-GROUP"
}

Remove tags from movie

Take one or more tags off a movie. The tags stay in Radarr for other movies.

Inputs

MoviemovietextRequired
The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
TagstagstextRequired
Tag names, separated by commas, such as kids, 4k. Radarr keeps them in lower case with hyphens.

Outputs

addedtext
When it was added to Radarr (UTC)
availabletrue/false
Whether it has reached its minimum availability
certificationtext
Its rating, such as PG-13
changed_tagslist
The tags added (or removed) by this step
digital_releasetext
When it came out digitally (UTC)
downloadedtrue/false
Whether Radarr has a file of it
fileobject
Its file, when it has one
genreslist
Its genres
idnumber
The movie's ID in Radarr, for other Radarr steps
imdb_idtext
Its IMDb ID, such as tt0133093
in_cinemastext
When it opened in cinemas (UTC)
linktext
A link to it in Radarr
minimum_availabilitytext
When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false
Whether Radarr looks for it and its upgrades
overviewtext
What it's about
pathtext
Its folder on Radarr's server
physical_releasetext
When it came out on disc (UTC)
poster_urltext
A link to its poster
quality_profiletext
Its quality profile's name
quality_profile_idnumber
Its quality profile's ID
ratingnumber
Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext
The root folder it's in
runtime_minutesnumber
How long it runs, in minutes
size_on_disknumber
How many bytes its files take
statustext
announced, inCinemas, released, tba or deleted
studiotext
Its studio
tagslist
Its tags' names
titletext
Its title
tmdb_idnumber
Its TMDB ID
tmdb_linktext
A link to it on TMDB
yearnumber
Its year
Example output
{
  "added": "2026-11-08T20:02:44Z",
  "available": true,
  "certification": "R",
  "changed_tags": [
    "family"
  ],
  "digital_release": "2001-03-19T00:00:00Z",
  "downloaded": true,
  "file": {
    "added": "2026-11-08T21:14:03Z",
    "edition": "",
    "id": 7,
    "path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
    "quality": "Bluray-1080p",
    "relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
    "release_group": "SPARKS",
    "size": 8804682752,
    "size_text": "8.2 GB"
  },
  "genres": [
    "Action",
    "Science Fiction"
  ],
  "id": 1,
  "imdb_id": "tt0133093",
  "in_cinemas": "1999-03-31T00:00:00Z",
  "link": "http://192.168.1.20:7878/movie/603",
  "minimum_availability": "released",
  "monitored": true,
  "overview": "A computer hacker learns the true nature of his reality.",
  "path": "/movies/The Matrix (1999)",
  "physical_release": "1999-11-25T00:00:00Z",
  "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "rating": 8.7,
  "root_folder": "/movies",
  "runtime_minutes": 136,
  "size_on_disk": 8804682752,
  "status": "released",
  "studio": "Village Roadshow Pictures",
  "tags": [],
  "title": "The Matrix",
  "tmdb_id": 603,
  "tmdb_link": "https://www.themoviedb.org/movie/603",
  "year": 1999
}

Search for movie

Have Radarr search its indexers for a movie now and grab the best release its quality profile allows, as its Search button does; or search for every missing movie.

Inputs

Moviemovietext
The movie to search for. Leave blank to search for every monitored movie that's missing.

Outputs

commandtext
The task, such as Movies Search
command_idnumber
Radarr's ID for the task
endedtext
When it finished (UTC)
finishedtrue/false
Whether it finished while the step waited
messagetext
What Radarr said when it finished
movie_idnumber
The movie's ID in Radarr; 0 for every movie
movie_titletext
The movie's title; blank for every movie
queuedtext
When it was queued (UTC)
startedtext
When it started (UTC)
statustext
queued, started or completed
Example output
{
  "command": "Movies Search",
  "command_id": 812,
  "ended": "2026-11-09T19:09:51Z",
  "finished": true,
  "message": "Completed",
  "movie_id": 1,
  "movie_title": "The Matrix",
  "queued": "2026-11-09T19:09:47Z",
  "started": "2026-11-09T19:09:47Z",
  "status": "completed"
}

Update movie

Change whether Radarr monitors a movie, its quality profile or its minimum availability, such as to stop looking once it's downloaded. Blank fields stay as they are.

Inputs

MoviemovietextRequired
The movie in Radarr's library: its title (with the year in brackets when two share one), its ID in Radarr, or tmdb:603.
Monitoredmonitoredtrue/false
On to have Radarr look for it and its upgrades, off to stop. Leave blank to keep it.
Quality profilequality_profiletext
A new quality profile, such as Ultra-HD. Leave blank to keep it.
Minimum availabilityminimum_availabilitytext
When Radarr starts looking for it: once it's announced, in cinemas, or released (on disc or digitally). Leave blank to keep it.One of: announced, inCinemas (In Cinemas), released.

Outputs

addedtext
When it was added to Radarr (UTC)
availabletrue/false
Whether it has reached its minimum availability
certificationtext
Its rating, such as PG-13
changedlist
What changed, such as monitored
digital_releasetext
When it came out digitally (UTC)
downloadedtrue/false
Whether Radarr has a file of it
fileobject
Its file, when it has one
genreslist
Its genres
idnumber
The movie's ID in Radarr, for other Radarr steps
imdb_idtext
Its IMDb ID, such as tt0133093
in_cinemastext
When it opened in cinemas (UTC)
linktext
A link to it in Radarr
minimum_availabilitytext
When Radarr starts looking: announced, inCinemas or released
monitoredtrue/false
Whether Radarr looks for it and its upgrades
overviewtext
What it's about
pathtext
Its folder on Radarr's server
physical_releasetext
When it came out on disc (UTC)
poster_urltext
A link to its poster
quality_profiletext
Its quality profile's name
quality_profile_idnumber
Its quality profile's ID
ratingnumber
Its IMDb rating out of 10 (TMDB's when IMDb has none)
root_foldertext
The root folder it's in
runtime_minutesnumber
How long it runs, in minutes
size_on_disknumber
How many bytes its files take
statustext
announced, inCinemas, released, tba or deleted
studiotext
Its studio
tagslist
Its tags' names
titletext
Its title
tmdb_idnumber
Its TMDB ID
tmdb_linktext
A link to it on TMDB
yearnumber
Its year
Example output
{
  "added": "2026-11-08T20:02:44Z",
  "available": true,
  "certification": "R",
  "changed": [
    "monitored"
  ],
  "digital_release": "2001-03-19T00:00:00Z",
  "downloaded": true,
  "file": {
    "added": "2026-11-08T21:14:03Z",
    "edition": "",
    "id": 7,
    "path": "/movies/The Matrix (1999)/The.Matrix.1999.1080p.BluRay.x264.mkv",
    "quality": "Bluray-1080p",
    "relative_path": "The.Matrix.1999.1080p.BluRay.x264.mkv",
    "release_group": "SPARKS",
    "size": 8804682752,
    "size_text": "8.2 GB"
  },
  "genres": [
    "Action",
    "Science Fiction"
  ],
  "id": 1,
  "imdb_id": "tt0133093",
  "in_cinemas": "1999-03-31T00:00:00Z",
  "link": "http://192.168.1.20:7878/movie/603",
  "minimum_availability": "released",
  "monitored": false,
  "overview": "A computer hacker learns the true nature of his reality.",
  "path": "/movies/The Matrix (1999)",
  "physical_release": "1999-11-25T00:00:00Z",
  "poster_url": "https://image.tmdb.org/t/p/original/dXNAPwY7VrqMAo51EKhhCJfaGb5.jpg",
  "quality_profile": "HD-1080p",
  "quality_profile_id": 4,
  "rating": 8.7,
  "root_folder": "/movies",
  "runtime_minutes": 136,
  "size_on_disk": 8804682752,
  "status": "released",
  "studio": "Village Roadshow Pictures",
  "tags": [
    "family"
  ],
  "title": "The Matrix",
  "tmdb_id": 603,
  "tmdb_link": "https://www.themoviedb.org/movie/603",
  "year": 1999
}

On this page