The Movie Database

The Movie Database Authentication API

The Authentication API from The Movie Database — 7 operation(s) for authentication.

GitHub OpenAPI

Operations 7

GET /3/authentication Validate Key #
GET /3/authentication/guest_session/new Create Guest Session #
GET /3/authentication/token/new Create Request Token #
POST /3/authentication/session/new Create Session #
POST /3/authentication/session/convert/4 Create Session (from v4 token) #
POST /3/authentication/token/validate_with_login Create Session (with login) #
DELETE /3/authentication/session Delete Session #

Documentation

📖
Documentation
https://developer.themoviedb.org/reference/intro/getting-started
📖
Authentication
https://developer.themoviedb.org/docs/authentication-application
📖
Documentation
https://developer.themoviedb.org/docs/getting-started
📖
GettingStarted
https://developer.themoviedb.org/docs/getting-started

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tmdb/refs/heads/main/openapi/tmdb-authentication-api-openapi.yml

Other Resources

🔗
Signup
https://www.themoviedb.org/signup
🔗
GetAPIKey
https://www.themoviedb.org/settings/api
🔗
ChangeLog
https://www.themoviedb.org/talk/category/5047958519c29526b50017d6
🔗
LlmsText
https://developer.themoviedb.org/llms.txt
🔗
Reference
https://developer.themoviedb.org/reference/getting-started

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tmdb-authentication-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tmdb-authentication-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: tmdb-api Account Authentication API
  version: '3'
servers:
- url: https://api.themoviedb.org
security:
- sec0: []
tags:
- name: Authentication
paths:
  /3/authentication:
    get:
      summary: Validate Key
      description: Test your API Key to see if it's valid.
      operationId: authentication-validate-key
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: '{"success":true,"status_code":1,"status_message":"Success."}'
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  status_code:
                    type: integer
                    example: 1
                    default: 0
                  status_message:
                    type: string
                    example: Success.
        '401':
          description: '401'
          content:
            application/json:
              examples:
                Result:
                  value: '{"status_code":7,"status_message":"Invalid API key: You must be granted a valid key.","success":false}'
              schema:
                type: object
                properties:
                  status_code:
                    type: integer
                    example: 7
                    default: 0
                  status_message:
                    type: string
                    example: 'Invalid API key: You must be granted a valid key.'
                  success:
                    type: boolean
                    example: false
                    default: true
      deprecated: false
      tags:
      - Authentication
  /3/authentication/guest_session/new:
    get:
      summary: Create Guest Session
      description: ''
      operationId: authentication-create-guest-session
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true,\n  \"guest_session_id\": \"1ce82ec1223641636ad4a60b07de3581\",\n  \"expires_at\": \"2016-08-27 16:26:40 UTC\"\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  guest_session_id:
                    type: string
                    example: 1ce82ec1223641636ad4a60b07de3581
                  expires_at:
                    type: string
                    example: 2016-08-27 16:26:40 UTC
      deprecated: false
      tags:
      - Authentication
  /3/authentication/token/new:
    get:
      summary: Create Request Token
      description: ''
      operationId: authentication-create-request-token
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true,\n  \"expires_at\": \"2016-08-26 17:04:39 UTC\",\n  \"request_token\": \"ff5c7eeb5a8870efe3cd7fc5c282cffd26800ecd\"\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  expires_at:
                    type: string
                    example: 2016-08-26 17:04:39 UTC
                  request_token:
                    type: string
                    example: ff5c7eeb5a8870efe3cd7fc5c282cffd26800ecd
      deprecated: false
      tags:
      - Authentication
  /3/authentication/session/new:
    post:
      summary: Create Session
      description: ''
      operationId: authentication-create-session
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - RAW_BODY
              properties:
                RAW_BODY:
                  type: string
                  format: json
            examples:
              Request Example:
                value:
                  request_token: 6bc047b88f669d1fb86574f06381005d93d3517a
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true,\n  \"session_id\": \"79191836ddaa0da3df76a5ffef6f07ad6ab0c641\"\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  session_id:
                    type: string
                    example: 79191836ddaa0da3df76a5ffef6f07ad6ab0c641
      deprecated: false
      tags:
      - Authentication
  /3/authentication/session/convert/4:
    post:
      summary: Create Session (from v4 token)
      description: ''
      operationId: authentication-create-session-from-v4-token
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - RAW_BODY
              properties:
                RAW_BODY:
                  type: string
                  format: json
            examples:
              Request Example:
                value:
                  access_token: eyK0eXAiOiJAV1QiLCJhbGciOiUIUzI1NiJ9.eyJhdWQiOiI0Ozc2YzA1ZTg4YTY1Yzk0MjFjZDI1NmBiYzRiNGE0NyIsInN1YiI6IjRiYzg4OTJhMDE3YTNjMGY5MjAwMDAwMiIsInNjb3BlayI6WyJhcGlfcmVhZCJdLCL2ZXJzaW9uIjoxfQ.Bn660W0Vi-_AI5HvwIEqtc2s5mAXDknBnTrUREZYH7A
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true,\n  \"session_id\": \"2629f70fb498edc263a0adb99118ac41f0053e8c\"\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  session_id:
                    type: string
                    example: 2629f70fb498edc263a0adb99118ac41f0053e8c
      deprecated: false
      tags:
      - Authentication
  /3/authentication/token/validate_with_login:
    post:
      summary: Create Session (with login)
      description: This method allows an application to validate a request token by entering a username and password.
      operationId: authentication-create-session-from-login
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - RAW_BODY
              properties:
                RAW_BODY:
                  type: string
                  format: json
            examples:
              Request Example:
                value:
                  username: johnny_appleseed
                  password: test123
                  request_token: 1531f1a558c8357ce8990cf887ff196e8f5402ec
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true,\n  \"expires_at\": \"2018-07-24 04:10:26 UTC\",\n  \"request_token\": \"1531f1a558c8357ce8990cf887ff196e8f5402ec\"\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  expires_at:
                    type: string
                    example: 2018-07-24 04:10:26 UTC
                  request_token:
                    type: string
                    example: 1531f1a558c8357ce8990cf887ff196e8f5402ec
      deprecated: false
      tags:
      - Authentication
  /3/authentication/session:
    delete:
      summary: Delete Session
      description: ''
      operationId: authentication-delete-session
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - RAW_BODY
              properties:
                RAW_BODY:
                  type: string
                  format: json
            examples:
              Request Example:
                value:
                  session_id: 2629f70fb498edc263a0adb99118ac41f0053e8c
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n  \"success\": true\n}"
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
      deprecated: false
      tags:
      - Authentication
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: bearer
x-readme:
  headers: []
  explorer-enabled: true
  proxy-enabled: true
x-readme-fauxas: true