### GET /hosts Source: https://api.real-debrid.com Get supported hosts. ```APIDOC ## GET /hosts ### Description Get supported hosts. This request is not requiring authentication. ### Method GET ### Endpoint /hosts ``` -------------------------------- ### Authorization URL Example Source: https://api.real-debrid.com Example URL for redirecting users to the authorization endpoint with required query parameters. ```text https://api.real-debrid.com/oauth/v2/auth?**client_id**=ABCDEFGHIJKLM&**redirect_uri**=https%3A%2F%2Fexample.com&**response_type**=code&**state**=iloverd ``` -------------------------------- ### GET /downloads Source: https://api.real-debrid.com Get the user's list of downloads. ```APIDOC ## GET /downloads ### Description Get the user's list of downloads. ### Method GET ### Endpoint /downloads ### Parameters #### Query Parameters - **offset** (int) - Optional - Starting offset - **page** (int) - Optional - Pagination system - **limit** (int) - Optional - Entries returned per page (0-5000, default: 100) ### Response #### Success Response (200) - **schema** (object) - Downloads list schema #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### POST /torrents/selectFiles/{id} Source: https://api.real-debrid.com Select files of a torrent to start it. ```APIDOC ## POST /torrents/selectFiles/{id} ### Description Select files of a torrent to start it, returns 204 HTTP code. ### Method POST ### Endpoint /torrents/selectFiles/{id} ### Parameters #### Request Body - **files** (string) - Required - Selected files IDs (comma separated) or "all" ``` -------------------------------- ### GET /settings Source: https://api.real-debrid.com Retrieves the current user settings and available values for updates. ```APIDOC ## GET /settings ### Description Get current user settings with possible values to update. ### Method GET ### Endpoint /settings ### Response #### Success Response (200) - **settings** (object) - Current user settings and configuration options. #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### GET /streaming/mediaInfos/{id} Source: https://api.real-debrid.com Get detailed media information for a given file. ```APIDOC ## GET /streaming/mediaInfos/{id} ### Description Get detailed media information for a given file, using the ID from /downloads or /unrestrict/link. ### Method GET ### Endpoint /streaming/mediaInfos/{id} ### Parameters #### Path Parameters - **id** (string) - Required - The file ID ### Response #### Success Response (200) - **schema** (object) - Media information schema #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) - 503: Service unavailable (problem finding metadata) ``` -------------------------------- ### GET /torrents/info/{id} Source: https://api.real-debrid.com Get all information on a specific torrent. ```APIDOC ## GET /torrents/info/{id} ### Description Get all information on the asked torrent. ### Method GET ### Endpoint /torrents/info/{id} ``` -------------------------------- ### GET /time Source: https://api.real-debrid.com Retrieves the current server time. ```APIDOC ## GET /time ### Description Get server time, raw data returned. This request is not requiring authentication. ### Method GET ### Endpoint /time ### Response #### Success Response (200) - **time** (string) - Server time in Y-m-d H:i:s format. ``` -------------------------------- ### GET /time/iso Source: https://api.real-debrid.com Retrieves the current server time in ISO format. ```APIDOC ## GET /time/iso ### Description Get server time in ISO, raw data returned. This request is not requiring authentication. ### Method GET ### Endpoint /time/iso ### Response #### Success Response (200) - **time** (string) - Server time in Y-m-dTH:i:sO format. ``` -------------------------------- ### GET /oauth/v2/device/code Source: https://api.real-debrid.com Initiates the device authentication process by requesting a device code and user code. ```APIDOC ## GET /oauth/v2/device/code ### Description Requests authentication data required to initiate the device flow. ### Method GET ### Endpoint /oauth/v2/device/code ### Parameters #### Query Parameters - **client_id** (string) - Required - The unique identifier for your application. ### Response #### Success Response (200) - **device_code** (string) - Code used for token requests. - **user_code** (string) - Code the user must enter at the verification URL. - **interval** (integer) - Polling interval in seconds. - **expires_in** (integer) - Expiration time in seconds. - **verification_url** (string) - URL where the user enters the user_code. ``` -------------------------------- ### GET /oauth/v2/device/code Source: https://api.real-debrid.com Initiates the device authorization flow to obtain authentication data. ```APIDOC ## GET /oauth/v2/device/code ### Description Initiates the device authorization flow by requesting a device code and user code. ### Method GET ### Endpoint /oauth/v2/device/code ### Parameters #### Query Parameters - **client_id** (string) - Required - The application client ID. - **new_credentials** (string) - Required - Set to 'yes' to indicate a request for new credentials. ### Response #### Success Response (200) - **device_code** (string) - The code used to poll for credentials. - **user_code** (string) - The code the user must enter at the verification URL. - **interval** (integer) - Polling interval in seconds. - **expires_in** (integer) - Expiration time in seconds. - **verification_url** (string) - The URL where the user enters the user_code. ``` -------------------------------- ### GET /streaming/transcode/{id} Source: https://api.real-debrid.com Get transcoding links for a given file. ```APIDOC ## GET /streaming/transcode/{id} ### Description Get transcoding links for a given file, using the ID from /downloads or /unrestrict/link. ### Method GET ### Endpoint /streaming/transcode/{id} ### Parameters #### Path Parameters - **id** (string) - Required - The file ID ### Response #### Success Response (200) - **schema** (object) - Transcoding links schema #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### GET /user Source: https://api.real-debrid.com Retrieves information about the current user. ```APIDOC ## GET /user ### Description Returns some informations on the current user. ### Method GET ### Endpoint /user ### Response #### Success Response (200) - **user_info** (object) - User show schema. ``` -------------------------------- ### GET /traffic Source: https://api.real-debrid.com Get traffic information for limited hosters including limits, current usage, and extra packages. ```APIDOC ## GET /traffic ### Description Get traffic information for limited hosters including limits, current usage, and extra packages. ### Method GET ### Endpoint /traffic ### Response #### Success Response (200) - **schema** (object) - Traffic information schema #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### GET /traffic/details Source: https://api.real-debrid.com Get traffic details on each hoster used during a defined period. ```APIDOC ## GET /traffic/details ### Description Get traffic details on each hoster used during a defined period. ### Method GET ### Endpoint /traffic/details ### Parameters #### Query Parameters - **start** (date) - Optional - Start period, default: a week ago (YYYY-MM-DD) - **end** (date) - Optional - End period, default: today (YYYY-MM-DD) ### Response #### Success Response (200) - **schema** (object) - Traffic details schema #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### GET /user Source: https://api.real-debrid.com Retrieves information about the currently authenticated user. ```APIDOC ## GET /user ### Description Retrieves the profile information for the authenticated user, including ID, username, email, points, and premium status. ### Method GET ### Endpoint https://api.real-debrid.com/rest/1.0/user ### Response #### Success Response (200) - **id** (int) - User ID - **username** (string) - Username - **email** (string) - User email address - **points** (int) - User points balance - **avatar** (string) - URL to user avatar - **type** (string) - Account type (e.g., premium) - **premium** (int) - Premium status identifier - **expiration** (string) - Premium expiration date #### Response Example { "id": 42, "username": "administrator", "email": "support@real-debrid.com", "points": 12347428, "avatar": "https://s.real-debrid.com/images/avatars/42424242424.png", "type": "premium", "premium": 666666, "expiration": "2032-06-06T04:42:42.000Z" } ``` -------------------------------- ### GET /torrents Source: https://api.real-debrid.com Retrieves the list of user torrents. ```APIDOC ## GET /torrents ### Description Get user torrents list. ### Method GET ### Endpoint /torrents ### Parameters #### Query Parameters - **offset** (int) - Optional - Starting offset (must be within 0 and _X-Total-Count_ HTTP header) - **page** (int) - Optional - Pagination system - **limit** (int) - Optional - Entries returned per page / request (must be within 0 and 5000, default: 100) - **filter** (string) - Optional - "active", list active torrents only ``` -------------------------------- ### GET /oauth/v2/device/credentials Source: https://api.real-debrid.com Polls for client credentials after the user has authorized the application. ```APIDOC ## GET /oauth/v2/device/credentials ### Description Polls the server to check if the user has authorized the application and to retrieve the bound client credentials. ### Method GET ### Endpoint /oauth/v2/device/credentials ### Parameters #### Query Parameters - **client_id** (string) - Required - The application client ID. - **code** (string) - Required - The device_code obtained from the initial request. ### Response #### Success Response (200) - **client_id** (string) - A new client_id bound to the user. - **client_secret** (string) - The client_secret to be used for token requests. ``` -------------------------------- ### GET /disable_access_token Source: https://api.real-debrid.com Disables the current access token. ```APIDOC ## GET /disable_access_token ### Description Disable current access token, returns 204 HTTP code. ### Method GET ### Endpoint /disable_access_token ### Response #### Success Response (204) - No content returned. ``` -------------------------------- ### GET /oauth/v2/auth Source: https://api.real-debrid.com Redirects the user to the authorization endpoint to grant application access. ```APIDOC ## GET /oauth/v2/auth ### Description Redirects the user to the authorization endpoint to initiate the three-legged OAuth2 flow. ### Method GET ### Endpoint https://api.real-debrid.com/oauth/v2/auth ### Parameters #### Query Parameters - **client_id** (string) - Required - Your application's client_id - **redirect_uri** (string) - Required - One of your application's redirect URLs (must be URL encoded) - **response_type** (string) - Required - Use the value "code" - **state** (string) - Required - An arbitrary string to help check against CSRF ``` -------------------------------- ### Instant Availability Check Source: https://api.real-debrid.com Returns information about file availability for specific hashes across different hosters. ```json { "string": { // First hash "string": [ // hoster, ex: "rd" // All file IDs variants { "int": { // file ID, you must ask all file IDs from this array on /selectFiles to get instant downloading "filename": "string", "filesize": int }, "int": { // file ID "filename": "string", "filesize": int } }, { "int": { // file ID "filename": "string", "filesize": int } } ] }, "string": { // Second hash "string": [ // hoster, ex: "rd" // All file IDs variants { "int": { // file ID, you must ask all file IDs from this array on /selectFiles to get instant downloading "filename": "string", "filesize": int }, "int": { // file ID "filename": "string", "filesize": int } }, { "int": { // file ID "filename": "string", "filesize": int } } ] } } ``` -------------------------------- ### Hoster Information Source: https://api.real-debrid.com Provides basic details about available hosters. ```json { "string": { // Host main domain "id": "string", "name": "string", "image": "string" // URL }, "string": { "id": "string", "name": "string", "image": "string" } } ``` -------------------------------- ### Alternative File Information Schema Source: https://api.real-debrid.com JSON schema for file details including alternative download options. ```json { "id": "string", "filename": "string", "filesize": int, // Filesize in bytes, 0 if unknown "link": "string", // Original link "host": "string", // Host main domain "chunks": int, // Max Chunks allowed "crc": int, // Disable / enable CRC check "download": "string", // Generated link "streamable": int, // Is the file streamable on website "type": "string", // Type of the file (in general, its quality) "alternative": [ { "id": "string", "filename": "string", "download": "string", "type": "string" }, { "id": "string", "filename": "string", "download": "string", "type": "string" } ] } ``` -------------------------------- ### File Information Schema Source: https://api.real-debrid.com JSON schema for file details including download links and host information. ```json { "id": "string", "filename": "string", "mimeType": "string", // Mime Type of the file, guessed by the file extension "filesize": int, // Filesize in bytes, 0 if unknown "link": "string", // Original link "host": "string", // Host main domain "chunks": int, // Max Chunks allowed "crc": int, // Disable / enable CRC check "download": "string", // Generated link "streamable": int // Is the file streamable on website } ``` -------------------------------- ### Hoster Max File Size Source: https://api.real-debrid.com Lists the maximum file size allowed for different hosts. ```json [ { "host": "string", // Host main domain "max_file_size": int // Max split size possible }, { "host": "string", // Host main domain "max_file_size": int // Max split size possible } ] ``` -------------------------------- ### Resource Creation Response Source: https://api.real-debrid.com Standard response structure for successfully created resources. ```json { "id": "string", "uri": "string" // URL of the created ressource } ``` -------------------------------- ### POST /torrents/addMagnet Source: https://api.real-debrid.com Add a magnet link to download. ```APIDOC ## POST /torrents/addMagnet ### Description Add a magnet link to download, return a 201 HTTP code. ### Method POST ### Endpoint /torrents/addMagnet ### Parameters #### Request Body - **magnet** (string) - Required - Magnet link - **host** (string) - Optional - Hoster domain (retrieved from /torrents/availableHosts) ``` -------------------------------- ### Domain List Source: https://api.real-debrid.com A simple array of domain strings. ```json [ "string", // Domain "string", "string" ] ``` -------------------------------- ### URL List Source: https://api.real-debrid.com A simple array of URL strings. ```json [ "string", // URL "string", "string" ] ``` -------------------------------- ### User Settings Schema Source: https://api.real-debrid.com JSON schema representing the current user settings object. ```json { "id": int, "username": "string", "email": "string", "points": int, // Fidelity points "locale": "string", // User language "avatar": "string", // URL "type": "string", // "premium" or "free" "premium": int, // seconds left as a Premium user "expiration": "string" // jsonDate } ``` -------------------------------- ### POST /unrestrict/folder Source: https://api.real-debrid.com Unrestricts a hoster folder link and returns individual links. ```APIDOC ## POST /unrestrict/folder ### Description Unrestrict a hoster folder link and get individual links, returns an empty array if no links found. ### Method POST ### Endpoint /unrestrict/folder ### Parameters #### Request Body - **link** (string) - Required - The hoster folder link ### Response #### Success Response (200) - **result** (array) - Show schema. ``` -------------------------------- ### POST /unrestrict/check Source: https://api.real-debrid.com Checks if a link is downloadable on the concerned hoster. ```APIDOC ## POST /unrestrict/check ### Description Check if a file is downloadable on the concerned hoster. This request is not requiring authentication. ### Method POST ### Endpoint /unrestrict/check ### Parameters #### Request Body - **link** (string) - Required - The original hoster link - **password** (string) - Optional - Password to unlock the file access hoster side ### Response #### Success Response (200) - **result** (object) - Show schema. ``` -------------------------------- ### POST /token Source: https://api.real-debrid.com Authenticates a user and retrieves an access token using either password-based or two-factor authentication grants. ```APIDOC ## POST /token ### Description Requests an access token from the Real-Debrid OAuth server. This endpoint supports password-based authentication and two-factor authentication flows. ### Method POST ### Endpoint /token ### Request Body - **client_id** (string) - Required - The application client identifier. - **username** (string) - Optional - User login (required for password grant). - **password** (string) - Optional - User password (required for password grant). - **grant_type** (string) - Required - The grant type, either "password" or "twofactor". - **code** (string) - Optional - The two-factor code received from the initial request. - **force_twofactor** (boolean) - Optional - Forces a two-factor authentication error for testing purposes. - **send** (boolean) - Optional - If true, triggers the sending of an SMS or email for two-factor validation. - **response** (string) - Optional - The security code input by the user for two-factor validation. ### Response #### Success Response (200) - **access_token** (string) - The OAuth access token. - **expires_in** (integer) - Token validity period in seconds. - **token_type** (string) - The type of token (e.g., "Bearer"). - **refresh_token** (string) - The token used to refresh the access token. #### Success Response (204) - No content returned (used for successful two-factor code trigger). ### Response Example { "access_token": "...", "expires_in": 3600, "token_type": "Bearer", "refresh_token": "..." } ``` -------------------------------- ### Daily Download Statistics Schema Source: https://api.real-debrid.com JSON schema for daily download statistics broken down by host. ```json { "YYYY-MM-DD": { "host": { // By Host main domain "string": int, // bytes downloaded on concerned host "string": int, "string": int, "string": int, "string": int, "string": int }, "bytes": int // Total downloaded (in bytes) this day }, "YYYY-MM-DD": { "host": { ``` -------------------------------- ### PUT /torrents/addTorrent Source: https://api.real-debrid.com Add a torrent file to download. ```APIDOC ## PUT /torrents/addTorrent ### Description Add a torrent file to download, return a 201 HTTP code. ### Method PUT ### Endpoint /torrents/addTorrent ### Parameters #### Query Parameters - **host** (string) - Required - Hoster domain (retrieved from /torrents/availableHosts) ``` -------------------------------- ### Forum Categories Source: https://api.real-debrid.com Lists forum categories and their associated IDs. ```json { "string": [ // Category name { "id": int, // Forum ID ``` -------------------------------- ### API Authentication via URL parameter Source: https://api.real-debrid.com Alternative method for authentication when HTTP headers cannot be set, using the auth_token query parameter. ```text /rest/1.0/method?auth_token=**your_api_token** ``` -------------------------------- ### POST /settings/update Source: https://api.real-debrid.com Updates a specific user setting. ```APIDOC ## POST /settings/update ### Description Update a user setting. Returns 204 on success. ### Method POST ### Endpoint /settings/update ### Parameters #### Request Body - **setting_name** (string) - Required - The name of the setting to update (e.g., "download_port", "locale"). - **setting_value** (string) - Required - The new value for the setting. ### Response #### Success Response (204) - No content returned. #### Error Handling - 400: Bad request (bad setting value or setting name) - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### RegExp List Source: https://api.real-debrid.com A simple array of regular expression strings. ```json [ "string", // RegExp "string", "string" ] ``` -------------------------------- ### PUT /settings/avatarFile Source: https://api.real-debrid.com Uploads a new user avatar image. ```APIDOC ## PUT /settings/avatarFile ### Description Upload a new user avatar image. Returns 204 on success. ### Method PUT ### Endpoint /settings/avatarFile ### Response #### Success Response (204) - No content returned. #### Error Handling - 400: Bad Request - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### Detailed Hoster Status Source: https://api.real-debrid.com Provides detailed status information for hosters, including competitor status. ```json { "string": { // Host main domain "id": "string", "name": "string", "image": "string", // URL "supported": int, // 0 or 1 "status": "string", // "up" / "down" / "unsupported" "check_time": "string", // jsonDate "competitors_status": { "string": { // Competitor domain "status": "string", // "up" / "down" / "unsupported" "check_time": "string" // jsonDate }, "string": { "status": "string", "check_time": "string" }, "string": { "status": "string", "check_time": "string" } } }, "string": { "id": "string", "name": "string", "image": "string", "supported": int, "status": "string", "check_time": "string", "competitors_status": { "string": { "status": "string", "check_time": "string" }, "string": { "status": "string", "check_time": "string" }, "string": { "status": "string", "check_time": "string" } } } } ``` -------------------------------- ### Obtain access token via two-factor authentication Source: https://api.real-debrid.com Use this cURL request to exchange a two-factor code for an access token. Requires prior authorization and a valid two-factor code. ```bash curl -X POST "https://api.real-debrid.com/oauth/v2/token" -d "**client_id**=ABCDEFGHIJKLM&**code**=ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789&**grant_type**=twofactor" ``` -------------------------------- ### Obtain Authentication Data URL Source: https://api.real-debrid.com Initial request to the device endpoint to retrieve the device and user codes. ```text https://api.real-debrid.com/oauth/v2/device/code?**client_id**=ABCDEFGHIJKLM&**new_credentials**=yes ``` -------------------------------- ### Generated Links List Schema Source: https://api.real-debrid.com JSON schema for a list of generated file links. ```json [ { "id": "string", "filename": "string", "mimeType": "string", // Mime Type of the file, guessed by the file extension "filesize": int, // bytes, 0 if unknown "link": "string", // Original link "host": "string", // Host main domain "chunks": int, // Max Chunks allowed "download": "string", // Generated link "generated": "string" // jsonDate }, { "id": "string", "filename": "string", "mimeType": "string", "filesize": int, "link": "string", "host": "string", "chunks": int, "download": "string", "generated": "string", "type": "string" // Type of the file (in general, its quality) } ] ``` -------------------------------- ### Open-source Client ID Source: https://api.real-debrid.com Use this client ID for open-source applications that do not require custom scopes or names. ```text X245A4XAIBGVM ``` -------------------------------- ### POST /token Source: https://api.real-debrid.com Exchanges a refresh token for a new access token. ```APIDOC ## POST /token ### Description Obtain a new access token by providing a previously saved refresh token. ### Method POST ### Endpoint /token ### Parameters #### Request Body - **client_id** (string) - Required - The client identifier. - **client_secret** (string) - Required - The client secret. - **code** (string) - Required - The refresh token value. - **grant_type** (string) - Required - Must be set to "http://oauth.net/grant_type/device/1.0". ### Response #### Success Response (200) - **access_token** (string) - The new access token. - **expires_in** (integer) - Token validity period in seconds. - **token_type** (string) - The type of token (e.g., "Bearer"). - **refresh_token** (string) - The new refresh token. ``` -------------------------------- ### POST /oauth/v2/token Source: https://api.real-debrid.com Exchanges credentials for an access token. ```APIDOC ## POST /oauth/v2/token ### Description Exchanges the obtained client credentials and device code for an access token. ### Method POST ### Endpoint /oauth/v2/token ### Parameters #### Request Body - **client_id** (string) - Required - The client_id obtained from the credentials endpoint. - **client_secret** (string) - Required - The client_secret obtained from the credentials endpoint. - **code** (string) - Required - The device_code. - **grant_type** (string) - Required - Must be 'http://oauth.net/grant_type/device/1.0'. ### Response #### Success Response (200) - **access_token** (string) - The token used for API requests. - **expires_in** (integer) - Token validity period in seconds. - **token_type** (string) - The type of token (Bearer). - **refresh_token** (string) - Token used to obtain new access tokens. ``` -------------------------------- ### Obtain access token via password grant Source: https://api.real-debrid.com Use this cURL request to authenticate using user credentials. Requires special client_id authorization from the webmaster. ```bash curl -X POST "https://api.real-debrid.com/oauth/v2/token" -d "**client_id**=ABCDEFGHIJKLM&**username**=abcdefghsecret0123456789&**password**=abcdefghsecret0123456789&**grant_type**=password" ``` -------------------------------- ### Retrieve user information via cURL Source: https://api.real-debrid.com Use this request to fetch the authenticated user's profile details. Requires a valid Bearer token in the Authorization header. ```bash curl -X GET \ -H "Authorization: Bearer your_api_token" \ "https://api.real-debrid.com/rest/1.0/**user**" ``` -------------------------------- ### POST /settings/convertPoints Source: https://api.real-debrid.com Converts user fidelity points. ```APIDOC ## POST /settings/convertPoints ### Description Convert fidelity points. Returns 204 on success. ### Method POST ### Endpoint /settings/convertPoints ### Response #### Success Response (204) - No content returned. #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) - 503: Service unavailable (not enough points) ``` -------------------------------- ### POST /oauth/v2/token Source: https://api.real-debrid.com Polls for an access token once the user has authorized the application. ```APIDOC ## POST /oauth/v2/token ### Description Exchanges the device code for an access token after user authorization. ### Method POST ### Endpoint /oauth/v2/token ### Parameters #### Request Body - **client_id** (string) - Required - The unique identifier for your application. - **client_secret** (string) - Required - The secret key for your application. - **code** (string) - Required - The device_code obtained from the initial request. - **grant_type** (string) - Required - Must be "http://oauth.net/grant_type/device/1.0". ### Response #### Success Response (200) - **access_token** (string) - The token used for authenticated requests. - **expires_in** (integer) - Token validity period in seconds. - **token_type** (string) - The type of token (e.g., "Bearer"). - **refresh_token** (string) - Token used to obtain new access tokens. ``` -------------------------------- ### Host Traffic Limits Schema Source: https://api.real-debrid.com JSON schema for tracking traffic limits per host. ```json { "string": { // Host main domain "left": int, // Available bytes / links to use "bytes": int, // Bytes downloaded "links": int, // Links unrestricted "limit": int, "type": "string", // "links", "gigabytes", "bytes" "extra": int, // Additional traffic / links the user may have buy "reset": "string" // "daily", "weekly" or "monthly" }, "string": { "left": int, "bytes": int, "links": int, "limit": int, "type": "string", "extra": int, "reset": "string" } } ``` -------------------------------- ### Obtain Access Token via cURL Source: https://api.real-debrid.com Perform a POST request to the token endpoint to exchange the authorization code for an access token. ```bash curl -X POST "https://api.real-debrid.com/oauth/v2/token" -d "**client_id**=ABCDEFGHIJKLM&**client_secret**=abcdefghsecret0123456789&**code**=ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789&**redirect_uri**=https://your-app.tld/realdebrid_api&**grant_type**=authorization_code" ``` -------------------------------- ### API Authentication Header Source: https://api.real-debrid.com Standard format for providing authentication credentials via HTTP headers. ```http Authorization: Bearer **your_api_token** ``` -------------------------------- ### POST /oauth/v2/token Source: https://api.real-debrid.com Exchanges an authorization code for an access token. ```APIDOC ## POST /oauth/v2/token ### Description Exchanges the authorization code received from the redirect for an access token. ### Method POST ### Endpoint https://api.real-debrid.com/oauth/v2/token ### Parameters #### Request Body - **client_id** (string) - Required - Your application's client_id - **client_secret** (string) - Required - Your application's client_secret - **code** (string) - Required - The authorization code received earlier - **redirect_uri** (string) - Required - One of your application's redirect URLs - **grant_type** (string) - Required - Use the value "authorization_code" ### Response #### Success Response (200) - **access_token** (string) - The access token for API requests - **expires_in** (integer) - Token validity period in seconds - **token_type** (string) - The type of token (Bearer) - **refresh_token** (string) - Token used to obtain new access tokens ``` -------------------------------- ### Detailed Torrent Information Source: https://api.real-debrid.com Provides comprehensive details about a specific torrent, including its file structure. ```json [ { "id": "string", "filename": "string", "original_filename": "string", // Original name of the torrent "hash": "string", // SHA1 Hash of the torrent "bytes": int, // Size of selected files only "original_bytes": int, // Total size of the torrent "host": "string", // Host main domain "split": int, // Split size of links "progress": int, // Possible values: 0 to 100 "status": "downloaded", // Current status of the torrent: magnet_error, magnet_conversion, waiting_files_selection, queued, downloading, downloaded, error, virus, compressing, uploading, dead "added": "string", // jsonDate "files": [ { "id": int, "path": "string", // Path to the file inside the torrent, starting with "/" "bytes": int, "selected": int // 0 or 1 }, { "id": int, "path": "string", // Path to the file inside the torrent, starting with "/" "bytes": int, "selected": int // 0 or 1 } ], "links": [ "string" // Host URL ], "ended": "string", // !! Only present when finished, jsonDate "speed": int, // !! Only present in "downloading", "compressing", "uploading" status "seeders": int // !! Only present in "downloading", "magnet_conversion" status } ] ``` -------------------------------- ### POST /unrestrict/link Source: https://api.real-debrid.com Unrestricts a hoster link and returns a new unrestricted link. ```APIDOC ## POST /unrestrict/link ### Description Unrestrict a hoster link and get a new unrestricted link. ### Method POST ### Endpoint /unrestrict/link ### Parameters #### Request Body - **link** (string) - Required - The original hoster link - **password** (string) - Optional - Password to unlock the file access hoster side - **remote** (int) - Optional - 0 or 1, use Remote traffic, dedicated servers and account sharing protections lifted ### Response #### Success Response (200) - **result** (object) - Show schema. ``` -------------------------------- ### Obtain access token via cURL Source: https://api.real-debrid.com Polling request to the token endpoint to exchange the device code for an access token once the user has authorized the application. ```bash curl -X POST "https://api.real-debrid.com/oauth/v2/token" -d "**client_id**=ABCDEFGHIJKLM&**client_secret**=abcdefghsecret0123456789&**code**=ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789&**grant_type**=http://oauth.net/grant_type/device/1.0" ``` -------------------------------- ### PUT /unrestrict/containerFile Source: https://api.real-debrid.com Decrypts a container file. ```APIDOC ## PUT /unrestrict/containerFile ### Description Decrypt a container file (RSDF, CCF, CCF3, DLC). ### Method PUT ### Endpoint /unrestrict/containerFile ### Response #### Success Response (200) - **result** (object) - Show schema. ``` -------------------------------- ### DELETE /torrents/delete/{id} Source: https://api.real-debrid.com Delete a torrent from the torrents list. ```APIDOC ## DELETE /torrents/delete/{id} ### Description Delete a torrent from torrents list, returns 204 HTTP code. ### Method DELETE ### Endpoint /torrents/delete/{id} ``` -------------------------------- ### Obtain authentication data via device code endpoint Source: https://api.real-debrid.com Initial request to the device endpoint to retrieve the necessary codes for user verification. ```http https://api.real-debrid.com/oauth/v2/device/code?**client_id**=ABCDEFGHIJKLM ``` -------------------------------- ### POST /settings/changePassword Source: https://api.real-debrid.com Sends a verification email to initiate a password change. ```APIDOC ## POST /settings/changePassword ### Description Send the verification email to change the password. Returns 204 on success. ### Method POST ### Endpoint /settings/changePassword ### Response #### Success Response (204) - No content returned. #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` -------------------------------- ### DELETE /downloads/delete/{id} Source: https://api.real-debrid.com Delete a link from the downloads list. ```APIDOC ## DELETE /downloads/delete/{id} ### Description Delete a link from the downloads list. ### Method DELETE ### Endpoint /downloads/delete/{id} ### Parameters #### Path Parameters - **id** (string) - Required - The link ID to delete ### Response #### Success Response (204) - No content returned #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) - 404: Unknown Resource ``` -------------------------------- ### POST /unrestrict/containerLink Source: https://api.real-debrid.com Decrypts a container file from a provided link. ```APIDOC ## POST /unrestrict/containerLink ### Description Decrypt a container file from a link. ### Method POST ### Endpoint /unrestrict/containerLink ### Parameters #### Request Body - **link** (string) - Required - HTTP Link of the container file ### Response #### Success Response (200) - **result** (object) - Show schema. ``` -------------------------------- ### Torrent List Response Source: https://api.real-debrid.com Represents a list of torrent objects with their current status, progress, and associated links. ```json [ { "id": "string", "filename": "string", "hash": "string", // SHA1 Hash of the torrent "bytes": int, // Size of selected files only "host": "string", // Host main domain "split": int, // Split size of links "progress": int, // Possible values: 0 to 100 "status": "downloaded", // Current status of the torrent: magnet_error, magnet_conversion, waiting_files_selection, queued, downloading, downloaded, error, virus, compressing, uploading, dead "added": "string", // jsonDate "links": [ "string" // Host URL ], "ended": "string", // !! Only present when finished, jsonDate "speed": int, // !! Only present in "downloading", "compressing", "uploading" status "seeders": int // !! Only present in "downloading", "magnet_conversion" status }, { "id": "string", "filename": "string", "hash": "string", "bytes": int, "host": "string", "split": int, "progress": int, "status": "downloaded", "added": "string", "links": [ "string", "string" ], "ended": "string" }, ] ``` -------------------------------- ### Active Torrents Limit Source: https://api.real-debrid.com Returns the current count and maximum limit of active torrents. ```json { "nb": int, // Number of currently active torrents "limit": int // Maximum number of active torrents you can have } ``` -------------------------------- ### Authentication data response structure Source: https://api.real-debrid.com The JSON object returned by the device code endpoint containing the user code and verification URL. ```json { "device_code": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "user_code": "ABCDEF0123456", "interval": 5, "expires_in": 1800, "verification_url": "https:\/\/real-debrid.com\/device" } ``` -------------------------------- ### Base URL for Real-Debrid API Source: https://api.real-debrid.com The root endpoint for all API requests. ```text https://api.real-debrid.com/rest/1.0/ ``` -------------------------------- ### OAuth2 Base URL Source: https://api.real-debrid.com The base endpoint for all OAuth2 authentication requests. ```text https://api.real-debrid.com/oauth/v2/ ``` -------------------------------- ### DELETE /settings/avatarDelete Source: https://api.real-debrid.com Resets the user avatar to the default image. ```APIDOC ## DELETE /settings/avatarDelete ### Description Reset user avatar image to default. Returns 204 on success. ### Method DELETE ### Endpoint /settings/avatarDelete ### Response #### Success Response (204) - No content returned. #### Error Handling - 401: Bad token (expired, invalid) - 403: Permission denied (account locked) ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.