Help

Your API key and security

Create a key on Torn Privacy Policy

The short version

Read-only, encrypted, and yours to delete

Encrypted at rest

Your key is encrypted in the database and every page is served over HTTPS.

Only ever reads

Torn API keys can only read. Torning cannot act in the game for you, and calls stay well below Torn's rate limits.

Yours to take or delete

Download everything Torning holds about you, or delete your account, from Privacy & data in the app.

Key levels

Which key to make

Public Only Too low Not enough to sign in.
Minimal Access Too low Not enough to sign in.
Limited Access Recommended Sign in, the dashboard, your faction's wars, chains and crimes, your stocks and bank.
Full Access Everything above, plus battle stats, networth and money flow from your logs.

Every call

Why Torning calls Torn

Each call carries a reason code you can see in Torn's own key log. Signed in, the Key usage page in the app counts yours.

Initial Authentication Call. Your API key is stored and your user and faction is created.
API key probe at Full Access level. Probe only, nothing is stored.
API key probe at Limited Access level. Probe only, nothing is stored.
API key probe at Minimal Access level. Probe only, nothing is stored.
API key probe for Faction AA permissions. Probe only, lets Torning know whether this key can eventually unlock faction features.
Resolves your Torn API key to your Torning account when the OC schedule script runs inside Torn PDA, where the login cookie is unavailable. Reads your public profile only, nothing is stored.
Daily re-check of whether your stored key has gained Faction AA permissions since you last signed in. Probe only, nothing is stored unless the answer is yes.

Scheduled sync of Torn's public item catalogue.
Scheduled sync of Torn's public calendar (competitions and events).
Scheduled sync of Torn's public crime catalogue.
Per-crime sync of sub-crime variants under a parent crime.
Scheduled sync of Torn's public education catalogue (subjects and courses).
Scheduled sync of Torn's public honors catalogue (one page per dispatch).
Scheduled sync of Torn's public medals catalogue (one page per dispatch).
Scheduled sync of Torn's public merit-upgrade catalogue.
Scheduled sync of Torn's public property catalogue.
Scheduled sync of Torn's public stock catalogue.
Scheduled refresh of your faction's public snapshot (leadership, respect, members). Keeps Torning in sync when leaders change.
Scheduled refresh of your public Torn profile. Keeps faction membership and status up to date.
Scheduled refresh of your faction's member list. Keeps the members page in step with leaves, joins and position changes.
Scheduled sync of Torn's public organised-crime catalogue (templates, slots, required items).
Scheduled sync of Torn's public territory map (sectors, sizes, slot counts, neighbours). The base catalogue faction-held territory joins against.
Scheduled sync of the Torn City Bank's current interest rates (1w/2w/1m/2m/3m). Drives the ROI comparison when the stocks "what to buy next" view ranks banking against stock benefits.
Scheduled refresh of each property type's market price. Feeds the stocks "what to buy next" view so random-property dividends (HRG) can be valued at their real market price rather than Torn's book cost.
Scheduled refresh of the cheapest current points-market listing. Lets the ranked-war payout deduction value faction-points refills at live market when leaders enable the "value faction use at market" option.
Monthly refresh of the /racing/tracks catalogue, shared by every faction running racing seasons. Names the track on every race page.
Monthly refresh of the /racing/cars catalogue, shared by every faction running racing seasons. Names and classes the cars on every race result.
Read of the public /racing/races custom-race list every five minutes while any faction has a racing season running. Only races created by a member of such a faction are kept; everything else is discarded unread.
Fetch of /racing/{raceId}/race for a faction race Torning is following, once it is due to have started and again until Torn reports it finished. Fills the race page, the season standings and the race summary.
One read of the public racing skill from /user/{id}/personalstats per faction member in a faction race, when its results land. Shown beside each driver on the race page.
Daily read of the public /racing/{trackId}/records top five for each car class on tracks a faction has raced. Shown on the track page beside the faction's own records.
One read of a faction's public /faction/{id}/basic profile when someone types its ID into War Intel, to confirm it exists and show its name before tracking it.
One read an hour of a faction's public /faction/{id}/rankedwars list, to show its last three finished ranked wars on War Intel.

Syncing your incoming stat changes (category 49). Powers the Battle Stats insights feature, showing how your stats have moved over time.
Scheduled refresh of your current battle stats. Populates the members stats view and the battle-stat current value everywhere.
Scheduled refresh of your bars (energy, nerve, happy, life, chain) plus your nerve perk bonus from the combined bars/perks selection. Feeds the members warring and crimes views.
Scheduled refresh of your drug / medical / booster cooldowns. Feeds the members warring view.
Syncing your stock buy log (category 132). Records each purchase so the stocks P&L view can show cost basis and annotated timeline.
Syncing your stock sell log (category 133). Records each sale plus Torn's reported profit so the stocks P&L view can total realised gains.
Syncing your stock special events log (category 134). Money dividends, item drops, nerve bonuses and withdrawal-ready notifications for the dashboard summaries.
Scheduled refresh of your current stock portfolio from /user/stocks. Share counts, purchase-lot cost basis, and bonus progress for the dashboard and "what to buy next" view.
Scheduled refresh of your purchased merits from /user/merits. Powers features that depend on merit perks (e.g. the stocks "what to buy next" view lights up the Bank 10-merit tier when you own Nothing for Nothing), and the daily checklist's unspent-merits row.
Scheduled refresh of your fixed-term bank deposit from /user/bank. Lets the stocks ROI view mark the bank row green when you already have money invested at the selected amount.
Syncing your bank log (category 59). Records each interest payout so the stocks insights view can attribute the TCI bonus interest you earned over time.
Syncing your item-market sale logs. Lets Torning reconcile faction armory gives against what you actually sold and received, without you doing the math.
Syncing your shop sale logs. Sits alongside the item-market sync so NPC-shop sales of faction armory items count toward reconciliation too.
Syncing your bazaar sale logs. Lets reconciliation see items that leave via your bazaar, not just the item market or shops.
Syncing your trade log (category 94). Captures items sold via player-to-player trade so reconciliation can match cache trades against the deposit you make afterwards.
Scheduled refresh of your currently equipped weapons, armour and clothing from /user/equipment. Powers the faction members "Equipment" view so leaders can verify everyone has the right setup.
Scheduled refresh of your inventory items from /user/inventory. Today this is the Enhancer category only (e.g. Large Suitcase) so the members view can flag who has the right travel/crime gear.
Per-minute snapshot: one merged call for bars (energy, nerve, happy, life, chain), battle stats and cooldowns, plus your nerve perk bonus. With the Daily Checklist turned on the same single call also returns your cash and bank investment, education course, available missions and mission credits, unread message and event counts, unspent job points, profile icons, bounties placed on you, casino tokens, the weapons and armour you have equipped with their ammo, your home's daily upkeep, and your hospital or jail status. Torn charges per call, not per item of data, so the checklist adds no extra API usage.
Scheduled refresh of your earned honors and medals from /user/honors,medals. Powers the upcoming Awards page and the Member Readiness CMG column (Carnage, Massacre, Genocide) so leaders can see who has landed the respect-tier hits.
Scheduled pull of your Torn crimes log so the Income insights tab can show crime money won and lost. Only runs if you have granted Income Insights.
Scheduled pull of your Torn attacking log so the Income insights tab can show money mugged from and lost to other players. Only runs if you have granted Income Insights.
Scheduled pull of your Torn factionpayout log so the Income insights tab can show faction payouts paid to you. Only runs if you have granted Income Insights.
Scheduled pull of your Torn money log so the Income insights tab can show cash sent to and received from other players. Only runs if you have granted Income Insights.
Scheduled pull of your Torn organizedcrimes log so the Income insights tab can show your cut of organised crime rewards. Only runs if you have granted Income Insights.
Scheduled pull of your Torn bounties log so the Income insights tab can show bounties you placed, collected and were paid. Only runs if you have granted Income Insights.
Scheduled pull of your Torn job log so the Income insights tab can show wages and job specials. Only runs if you have granted Income Insights.
Scheduled pull of your Torn racing log so the Income insights tab can show race entry fees and winnings. Only runs if you have granted Income Insights.
Scheduled pull of your Torn missions log so the Income insights tab can show mission rewards and costs. Only runs if you have granted Income Insights.
Scheduled pull of your Torn travel log so the Income insights tab can show flight costs and what you bought abroad. Only runs if you have granted Income Insights.
Scheduled pull of your Torn property log so the Income insights tab can show property purchases, sales, upkeep and rent. Only runs if you have granted Income Insights.
Scheduled pull of your Torn hunting log so the Income insights tab can show money made hunting overseas. Only runs if you have granted Income Insights.
Scheduled pull of your Torn casino log so the Income insights tab can show casino wins and losses across every game. Only runs if you have granted Income Insights.
Scheduled pull of your Torn bail log so the Income insights tab can count bail you paid to free other players. Only runs if you have granted Income Insights.
Scheduled pull of your Torn points market log so the Income insights tab can count points you bought and sold. Only runs if you have granted Income Insights.
Scheduled pull of your Torn auction house log so the Income insights tab can count auctions you won and items you sold there. Only runs if you have granted Income Insights.
Hourly reading of your Torn networth breakdown (wallet, vault, bank, items, assets and points) so the Networth insights tab can chart what you are worth over time. Only runs if you have granted Income Insights.
One-off walk back through Torn's daily networth history so the Networth insights tab starts with your past rather than with today. Only runs if you have granted Income Insights.
Developer-only read of a few log pages, used to learn the payload shape Torn sends for a log type. Nothing is stored against your account.
Scheduled pull of your Torn education log so the Income insights tab can count what your courses cost. Only runs if you have granted Income Insights.
Scheduled read of your faction balance alongside the hourly wealth reading, so the Networth tab can show money you are holding in a faction vault. Torn leaves faction-held money out of your networth entirely, so without this the figure is missing from your total. Only runs if you have granted Income Insights and are in a faction.
Daily read of the properties you own so the Networth tab can tell a rented-out portfolio earning its keep from an island sitting idle and costing upkeep. Torn reduces every property you hold to a single figure in your networth, which cannot show the difference. Only runs if you have granted Income Insights.
Reads your lifetime "items bought from the city" counter from /user/personalstats, plus the same counter as it stood at Torn midnight. The difference is how many of the daily 100 city purchases you have left. Nothing else in that response is stored.
Reads your own activity log (/user/log) for a few specific entries only: church prayers, church donations, casino wheel spins, and the bounties you have placed on other players. Torn exposes none of these anywhere else. The read covers the last seven days because that is how long a bounty listing lasts. Only the fact that each happened is kept, plus how many of your bounties are still unclaimed and what they are worth. Never the amounts you donated or won, and never who you placed a bounty on or why. Needs a Full Access key.
Looks up which Torn account a Discord user belongs to, using the link the player set up in Torn themselves. This is how the Discord bot knows who it is talking to, so it never has to ask for a code or a key.
Hourly fetch of your own nerve spent per crime from /user/{crimeId}/crimes, one call per crime, while your faction runs a Nerve Burner competition, plus one round just before the start and one just before the end. The total is compared with its value at the start to rank the standings. Nothing is pulled outside a competition window, and only your own key ever reads your figures.
Hourly fetch of your own custom races from /user/races while your faction runs a racing season. It is the only place Torn reports the racing skill you gained per race, and it picks up races you joined that no member created. Only your own key ever reads your races.
One read of /user/travel (plus your perks, for carry capacity) when you open the Travel page or the Travel planner, or run /travel eta, /travel alarm or /travel stock in Discord. One call each time, nothing scheduled, and only your own key is used.
Once a day, just before the Torn reset, reads a handful of your lifetime counters from /user/personalstats (attacks won, lost and stealthed, respect earned, missions, crimes, Xanax taken and the four battle stats) as they stand now and as they stood at the two previous Torn midnights. The differences are your day and the day before, for the Daily summary Discord message. Only runs while that alert is on, only your own key is used, and nothing from the response is stored.
Once a day while your faction runs a Xanax Marathon, Sugar Rush, Pub Crawl, Mugging Madness or Bounty Hunters, reads the matching entries of your own log over the competition window (Xanax, candy and alcohol use, mugs or bounty claims). The total is only compared with the score Torning counted from your public counter, to catch drift. Nothing from the log is stored and it never changes your score.
Every five minutes, reads the item-receive entries of the Pro recipient's own log to find Xanax sent to pay for Pro. Only that one account's key is used, and only the sender, the Xanax count and the time are stored.
One read of a faction's public /faction/{id}/members roster when you open the War Hub in the Torning browser extension. Your own key is used, the answer is shared with everyone looking at the same faction for five seconds, and nothing is stored.
Daily fetch of your own enlisted cars from /user/enlistedcars while your faction uses racing. It shows each car's stats on your racing driver page, in race results and on track pages, so faction mates can see what you drive. Only your own key ever reads your cars.
One read of /user/bars when you open the Travel planner with an energy or nerve waste limit set, to drop trips that would leave a bar full too long. Skipped when your bars synced in the last minute. Nothing scheduled, and only your own key is used.
One read of /user/cooldowns when you open the Travel planner with "Be home when my drug cooldown ends" on, so trips land you back in Torn before it runs out. Skipped when your cooldowns synced in the last minute. Nothing scheduled, and only your own key is used.
Only while the Goals section of your daily checklist is switched on: a quarter-hourly read of /user/personalstats for your busts, revives, bounties collected, Xanax taken, races entered and racing skill, plus the same counters at Torn midnight and thirty days ago once a day. The differences are your counts for today and your daily pace.
Hourly read of the Plushie and Flower categories of /user/inventory, so the checklist can tell you when you hold a full set for the Museum. Only the counts of those items are kept.
Scheduled or on-demand fetch of your personal targets list from Torn to view target battle stats, hospital timers, and status in Torning.

Scheduled read of your company from /company/profile,employees. Powers the checklist rows for available employee trains, free desks, and colleagues serving federal time, and for a director: daily profit, popularity and employee effectiveness and activity.
For a company director only: a read of /company/stock alongside the company sync, so the checklist can warn when a product line will sell out before a new order arrives.

Scheduled refresh of your faction's news feed across every tracked category. Powers the faction audit log (OC payouts, armory activity, money transfers, leadership changes).
Scheduled refresh of your faction's organised-crime instances (participants, outcomes, rewards, payouts). Links OC payouts back to the specific crime they came from.
Scheduled refresh of the territories your faction currently holds, including active rackets and their rewards. Feeds the audit log when territory items land in the armory.
Scheduled refresh of your faction's ranked-war list. Feeds the ranked wars page and lets the ledger attribute war payouts back to the war they came from.
Per-war fetch of the final ranked-war report once a war ends. Captures rewards (respect, points, item drops) so the ledger can link armory distributions back to the win.
Per-war fetch of every faction attack inside a ranked-war window. Feeds the payout calculator so points and respect can be attributed to the members who scored them.
Per-war fetch of every chain run inside a ranked-war window. Lets the payout calculator group attacks by chain when distributing payouts.
Scheduled snapshot of your faction armoury (weapons, armor, temporary, medical, drugs, boosters, caches, utilities, cesium). Powers the armoury page so leaders can see what is in stock and what is loaned out to whom.
Per-member fetch of /user/{id}/personalstats?cat=drugs while a ranked war is in prep. Baselines lifetime overdoses at prep start and refreshes the current count so the Member Readiness table can show ODs taken during prep.
Pulls /faction/balance and /faction/upgrades each crimes sync tick to mirror the faction's current Scope balance and Organized Crimes unlock level for the spawn recommender.
Per-member fetch of /user/{id}/personalstats?cat=crimes for your faction. Reads public crime skills and offense counts so the organised-crime planner can estimate a pass rate for members we have no synced rate for yet.
Scheduled snapshot of /faction/balance: the faction bank's money and points plus each member's balance. Powers the accounting page's vault, custody and points figures and their history.
Scheduled read of your faction's pending membership applications from /faction/applications. Powers the dashboard checklist row that tells leaders an application is waiting. Needs an AA key.
Opt-in half-minute poll of the last few faction attacks, so the Discord bot can flag an incoming hit while the five-minute retaliation window is still open. Only runs while a faction has the live retaliation alert switched on.
Half-minute read of /faction/chain while your faction is chaining. The only source for the live hit count and the seconds left, which is what the chain timer warning and bonus hit bookings both run on. Costs nothing while nobody is chaining.
Daily per-member fetch of ten public activity counters (time played, active streak, attacks, ranked war hits, crimes, OCs, revives, flights, refills, Xanax) from /user/{id}/personalstats, now and as of 7 and 30 days ago, for every enrolled faction with a Faction-AA key. Powers the member table on the War Intel tab, /members activity and /members xanax.
Daily per-member fetch of the public time-spent-travelling counter from /user/{id}/personalstats while a faction competition is running. Used only to cross-check the flight time Torning sampled against Torn's own figure.
Daily fetch of /faction/upgrades for factions with the Competitions module on, plus once when a leader first opens the Competitions tab. Records only whether the reviving upgrade is unlocked, which gates the Revive Rally competition type.
Fetch of /faction/revives (outgoing only) every five minutes while a Revive Rally competition is running. Feeds the rally standings; nothing is pulled outside a competition window.
Fetch of /faction/contributors (energy trained, successful busts) every five minutes while an Energy Dump or Jailbreakers competition is running, one call per counter. Each member's counter is compared with its value at the start to rank the standings; nothing is pulled outside a competition window.
Hourly per-member fetch of the public Xanax, candy, alcohol, money-mugged and bounty-reward counters from /user/{id}/personalstats while a Xanax Marathon, Sugar Rush, Pub Crawl, Mugging Madness or Bounty Hunters competition is running, plus one read just before the start and one just before the end. Each counter is compared with its value at the start to rank the standings; nothing is pulled outside a competition window.

Retention

How long things are kept

Your key and account: Until you delete your account, then erased 7 days after you ask.
Each API call made for you: Individual API calls are deleted after 14 days.
Data exports: The zip is deleted 7 days after it is built; the request record stays until you delete your account.