{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","name":"Main API","description":"### Full documentation for TorBox\n\nCurrent API Base: `https://api.torbox.app`\n\nCurrent API Version: `v1`\n\nYou can find more API docs here: [http://api.torbox.app/docs](http://api.torbox.app/docs) (they aren't as great as these, but is in a format most people would be familiar to).\n\n### General Information\n\n- You can rely on both `success` booleans or status codes to determine if a call was a success. Status code `200` always means a success. `403` means authentication error. `500` means something went wrong on TorBox's end. `400` means the user did something wrong, or an input wasn't correct, or expected.\n    \n- There will always be a user-friendly message in `detail` for a reason why a call was a failure, or a success message. You may forward these directly to users.\n    \n- The `/usenet` and the `/webdl` API endpoints are nearly the same as the `/torrents` API endpoints apart from some different named inputs and outputs.\n    \n- All outputs are JSON unless otherwise specified. Check out the examples to be sure.\n    \n\n### Rate Limits\n\n- Unless stated below, all endpoints are rate limited to **300/min** per API token, no edge rate limiting.\n    \n- `POST` /torrents/createtorrent is rate limited to **60/hour** per API token.\n    \n- `POST` /usenet/createusenetdownload is rate limited to **60/hour** per API token.\n    \n- `POST` /webdl/createwebdownload is rate limited to **60/hour** per API token.\n    \n- We no longer accept IP whitelisting requests due to rate limiting being API token based, rather than IP based.\n    \n\n### Standard Response\n\nBelow is the standard JSON response that most requests will return. In short, always use the \"success\" key to determine if a request was successful or not, \"error\" to determine the exact error reason, \"detail\" as a user-friendly message whether success or error, and data contains the response information you are looking for.\n\n``` json\n{\n    \"success\": boolean, // whether a response is successful or not\n    \"error\": string, // an error code if there was an error, or null if success\n    \"detail\": string, // a user-friendly message\n    \"data\": any // usually an object/dict, but can be anything, check the examples\n}\n\n ```\n\n### Errors Table\n\nErrors codes are part of the standard response type. If the code ends in \"ERROR\", the error is the server's fault else that error is something that the client caused.\n\n| **Error Code** | Error Meaning |\n| --- | --- |\n| DATABASE_ERROR | Could not access internal database/memory store information. |\n| UNKNOWN_ERROR | The reason for the error is unknown. Usually there will be error data attached in the \"data\" key. In these cases please report the request to [contact@torbox.app](https://mailto:contact@torbox.app). |\n| NO_AUTH | There are no provided credentials. |\n| BAD_TOKEN | The provided token is invalid. |\n| AUTH_ERROR | There was an error verifying the given authentication. |\n| INVALID_OPTION | The provided option is invalid. |\n| REDIRECT_ERROR | The server tried redirecting, but it faulted. |\n| OAUTH_VERIFICATION_ERROR | The server tried verifying your OAuth token, but it was not accepted by the provider. |\n| ENDPOINT_NOT_FOUND | If you have hit an endpoint that doesn't exist. |\n| ITEM_NOT_FOUND | The item you queried cannot be found. |\n| PLAN_RESTRICTED_FEATURE | This feature is restricted to users of higher plans. The user is recommended to upgrade their plan to use this endpoint. |\n| DUPLICATE_ITEM | This item already exists. |\n| BOZO_RSS_FEED | This RSS feed is invalid or not a well-formed XML. |\n| TOO_MUCH_DATA | Client sent too much data to the API. Please keep requests under 100MB in size. |\n| DOWNLOAD_TOO_LARGE | This download is oversized for the user's plan. The user is recommended to upgrade their plan to download this file.  <br>  <br>Free Plan Limit: **10737418240** bytes  <br>Essential Plan Limit: **214748364800** bytes  <br>Standard Plan Limit: **214748364800** bytes  <br>Pro Plan Limit: **536870912000** bytes |\n| MISSING_REQUIRED_OPTION | The API is missing required information to process the request. |\n| TOO_MANY_OPTIONS | Client sent too many options. Usually this has to do with the API requiring only 1 option but the client sent more than the required. |\n| BOZO_TORRENT | The torrent sent is not a valid torrent. |\n| NO_SERVERS_AVAILABLE_ERROR | There are no download servers available to handle this request. This should never happen. If you receieve this error, please contact us at [contact@torbox.app](https://mailto:contact@torbox.app). |\n| MONTHLY_LIMIT | User has hit the maximum monthly limit. It is recommended user upgrade their account to be able to download more. |\n| COOLDOWN_LIMIT | User is on download cooldown. It is recommended user upgrade their account to be able to bypass this restriction. |\n| ACTIVE_LIMIT | User has hit their max active download limit. It is recommended user upgrade their account or purchase addons to bypass this restriction. |\n| DOWNLOAD_SERVER_ERROR | There was an error interacting with the download on the download server. It is recommdned to simply wait some time before trying again. |\n| BOZO_NZB | The NZB sent is not a valid NZB file. |\n| SEARCH_ERROR | There was an error searching using the TorBox Search API. |\n| INVALID_DEVICE | The client is sending requests from the incorrect device. |\n| DIFF_ISSUE | The request parameters sent does not allow for this request to complete. |\n| LINK_OFFLINE | The link given is inaccessible or has no online files. |\n| VENDOR_DISABLED | This vendor account has been disabled. Please contact support. |\n| BOZO_REGEX | The regex you entered is bad. |\n| BAD_CONFIRMATION | The confirmation code you have given is invalid. |\n| CONFIRMATION_EXPIRED | The confirmation code you have given is expired. Request a new code. |\n| BOZO_FILE | This file doesn't match the required mimetype. Please use a different file. |\n\n### Translation to Real-Debrid API\n\nUseful for if you want to add TorBox to an app where Real-Debrid is already existing. These are the API routes that are nearly the same with Real-Debrid API routes. You will have to change things such as parameters and check outputs as they both are not the same. You can find docs to Real-Debrid's API [here](https://api.real-debrid.com/).\n\n| Real-Debrid API Routes | TorBox API Routes |\n| --- | --- |\n| `GET` /torrents | `GET` /torrents/mylist |\n| `GET` /torrents/info/{id} | `GET` /torrents/mylist?id={id} |\n| `GET` /torrents/instantAvailability/{hash} | `GET` /torrents/checkcached |\n| `PUT` /torrents/addTorrent | `POST` /torrents/createtorrent |\n| `POST` /torrents/addMagnet | `POST` /torrents/createtorrent |\n| `POST` /torrents/selectFiles/{id} | **None**, _not needed. Torrents will download all files. This will not be changed._ |\n| `DELETE` /torrents/delete/{id} | `POST` /torrents/controltorrent |\n| `POST` /unrestrict/link | `GET` /torrents/requestdl |\n\n### Dates\n\nAll dates returned from the API are normalized to UTC time. All dates are in the format:\n\n`%Y-%m-%dT%H:%M:%SZ`\n\nExample: `2024-10-21T20:47:03Z` = The 21st of October, 2024 at 8:47:03 PM UTC.\n\nThis makes it easy for users and integrations to parse these dates and change them to the user's time zone for better UX. For more information on these formats, you can take a look at this [cheat sheet](https://strftime.org/).\n\n### SDK\n\nThere are many official and even non-official community created SDKs that wrap TorBox's API making it simple for developers to easily and quickly create applications using TorBox's API with their native programming language. There are already SDKs for the most popular languages and more are being added all the time!\n\n_Note: Being the official SDK does not mean you should use it over another SDK of the same language. There are some very impressive and highly updated SDKs!_\n\n| **Language** | **Project Link** | **Official** |\n| --- | --- | --- |\n| Python | [https://github.com/TorBox-App/torbox-sdk-py](https://github.com/TorBox-App/torbox-sdk-py) | **YES** |\n| Python | [https://github.com/eliasbenb/TorBox.py](https://github.com/eliasbenb/TorBox.py) | **NO** |\n| Javascript/Typescript | [https://github.com/TorBox-App/torbox-sdk-js](https://github.com/TorBox-App/torbox-sdk-js) | **YES** |\n| Javascript/Typescript | [https://www.npmjs.com/package/node-torbox-api](https://www.npmjs.com/package/node-torbox-api) | **NO** |\n| Go | [https://github.com/TorBox-App/torbox-sdk-go](https://github.com/TorBox-App/torbox-sdk-go) | **YES** |\n| C# | [https://github.com/asylumexp/TorBox.NET](https://github.com/asylumexp/TorBox.NET) | **NO** |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"29572726","team":11190918,"collectionId":"4244cdaf-ece6-4b6d-a2ca-463a3af48f54","publishedId":"2s9YXo1zX4","public":true,"publicUrl":"https://api-docs.torbox.app","privateUrl":"https://go.postman.co/documentation/29572726-4244cdaf-ece6-4b6d-a2ca-463a3af48f54","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-03-11T04:33:37.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"Production","id":"1b0d18ed-d45c-43f1-ad3f-253c7d41f915","owner":"29572726","values":[{"key":"api_base","value":"https://api.torbox.app","enabled":true,"type":"default"},{"key":"api_version","value":"v1","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/1886bd08c5df32624f487761e695684f3107674bf949b5644d3c31c3d6246492","favicon":"https://torbox.app/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"29572726-1b0d18ed-d45c-43f1-ad3f-253c7d41f915"}],"canonicalUrl":"https://api-docs.torbox.app/view/metadata/2s9YXo1zX4"}