Release Dates

This endpoint is used to get the release dates and certifications for a movie.

GET /movie/{movie_id}/release_dates

Release Dates

cURL

curl --request GET \
  --url https://api.themoviedb.org/3/movie/{movie_id}/release_dates \
  --header 'Authorization: Bearer <token>'

200

{
  "id": 550,
  "results": [
    {
      "iso_3166_1": "AE",
      "release_dates": [
        {
          "certification": "",
          "descriptors": [],
          "iso_639_1": "",
          "note": "Blu-ray",
          "release_date": "2009-11-23T00:00:00.000Z",
          "type": 5
        }
      ]
    },
    {
      "iso_3166_1": "AR",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-04T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "AU",
      "release_dates": [
        {
          "certification": "R 18+",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-11T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "BE",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-10T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "BG",
      "release_dates": [
        {
          "certification": "c",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "2012-08-28T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "BR",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-10-29T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "CA",
      "release_dates": [
        {
          "certification": "18A",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-10-15T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "CH",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "fr",
          "note": "",
          "release_date": "1999-11-10T00:00:00.000Z",
          "type": 3
        },
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "de",
          "note": "",
          "release_date": "1999-11-04T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "CZ",
      "release_dates": [
        {
          "certification": "18+",
          "descriptors": [],
          "iso_639_1": "",
          "note": "Febio Film Festival",
          "release_date": "2000-01-25T00:00:00.000Z",
          "type": 1
        },
        {
          "certification": "18+",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "2000-02-10T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "DE",
      "release_dates": [
        {
          "certification": "18",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-11T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "DK",
      "release_dates": [
        {
          "certification": "15",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "1999-11-05T00:00:00.000Z",
          "type": 3
        }
      ]
    },
    {
      "iso_3166_1": "EE",
      "release_dates": [
        {
          "certification": "",
          "descriptors": [],
          "iso_639_1": "",
          "note": "",
          "release_date": "2000-01-07T00:00:00.000Z",
          "type": 3
        }
      ]
    }
  ]
}

Release	Type
Premiere	1
Theatrical (limited)	2
Theatrical	3
Digital	4
Physical	5
TV	6

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

movie_id · integer · required

The ID of the movie

Response

200 - application/json

Successful

id · integer

A unique identifier for the movie

results · object[]

Contains the list of data or items

Show child attributes