Terms of Service

Torn API compliance declaration for The Untouchables

API Data Usage Declaration

As required by the Torn API Terms of Service, we declare the following about how we store and use data obtained via your API key:

Data Storage Data Sharing Purpose of Use Key Storage & Sharing Key Access Level
Persistent — until account deletion Faction members (faction-specific data only) Non-malicious statistical analysis, faction management and coordination tools Stored securely (hashed/encrypted), used only for automation, accessible to service owner for maintenance only Custom — specific selections listed below

Required API Selections

Your custom API key requires the selections listed below. Some support features that are live today; others are reserved for planned features and are clearly labelled as such. Locking the full set in now means you will not be asked to regenerate your key when those features ship.

Section Selection Purpose
user basic Verify your Torn identity (name, player ID) on login
user faction Determine your current faction membership and position so the app can map your access level
faction basic Read your faction's basic information when calling faction-scoped endpoints with your key
faction crimes Scan your checkpoint pass rate (CPR) for each organized crime role so the OC module can suggest assignments
user profile Show your extended profile (signup date, donator status, last action) on member detail pages — planned
user personalstats Member analytics, OC participation totals, war contributions, and faction leaderboards — planned
user criminalrecord Display your overall criminal record stats outside organised crimes — planned
user bars Show your current energy, nerve, happy and life bars for chain and OC readiness indicators — planned
user cooldowns Track drug, booster and medical cooldowns for war and chain preparation tooling — planned
user gym Track your gym training stats over time for personal development insights — planned
user refills Show whether your daily energy and nerve refills are still available for chain prep — planned
user skills Read player skills (driving, racing, etc.) — a future component of CPR calculations in the OC module — planned
user travel Show your current travel status for chain and war participation timing — planned
user attacks Track your contributions to ranked wars and chains based on recent attack history — planned
user battlestats Read your battle stats (strength, defense, speed, dexterity) for war preparation, member rankings and OC role suggestions — planned
user crimes Read your personal organized crime history and success rates for member detail pages — planned

Selections marked planned are requested up front so you will not be asked to regenerate your key when the corresponding feature ships. Each one is your own data and is granted by you when you create the custom key. This list is the complete set required by the app — if it ever changes, this page is updated alongside the change and you will be notified.

Faction AA Key (leader-configured)

Some features use a separate Faction AA key configured by the faction leader. This key is never exposed to members and requires these additional selections:

Section Selection Purpose
faction basic Verify faction identity and API key validity
faction members Sync the faction member roster (names, positions, levels)
faction crimes Sync organized crime history and active OC status
faction currency Read faction vault totals (money and points)
faction donations Read member vault balances (money and points per member)
faction fundsnews Sync vault transaction history for the faction ledger
faction armorynews Detect organized crime item-reward distributions and track per-member drug and energy refill usage during chains
torn items Resolve item names for OC material tracking (public data)
faction attacks Sync attack history during ranked wars to calculate member contributions and pay
faction chain Read the live chain status (hit count, timeout, cool-down) during active ranked wars
faction rankedwars Discover and track ranked war status (start, end, scores, opponent) for the War module
faction rankedwarreport Fetch the final ranked war report (total hits, scores, participants) once a war ends
faction chains Fetch the faction chain history list (chain IDs, hit counts, respect earned, start/end times) for the Chain module
faction chainreport Fetch per-member chain contribution data (hits, respect, avg respect, best hit, bonus hits, outcome breakdown) and store indefinitely for historical rankings

Optional: Sharing Your Key with the Faction Pool

The app uses the faction's AA key for most requests, which has a Torn-imposed limit of ~100 calls per minute. Some features (such as overdose tracking) need user/personalstats, which the AA key cannot access. To support these features without overloading any single key, members can opt in to let the app server include their personal API key in a per-faction pool.

Specifically, when you enable Share API Key with the App in your settings:

Sharing is entirely optional. The app remains usable without opting in; only features that require user-tier endpoints (such as overdose tracking) will be unavailable to your faction unless at least one member has opted in.

Your Rights

✓ You can delete your account and all associated data at any time from your account settings.
✓ This tool only accesses data through the official Torn API — we make no direct requests to Torn outside of the API.
✓ Your API key is never shared with other users or third parties. If you opt in to the faction key pool (see above), the app server uses your key to make API calls on the faction's behalf — other users never see or receive it.
✓ We only store the data fields we actually use — raw API responses are never persisted.
✓ Faction-specific data is scoped to your faction and is never visible to members of other factions.

Contact

For questions about data usage, to request manual account deletion, or to report a problem, contact the service owner: