Wiki

πŸ“– Torn Hub Wiki

Help and documentation for all features – no login required.

πŸ“– Property Help & Logs
How Property Logs Work

All property data is now stored in MySQL – lease history, tenant info, and lifetime income are in the database, not in JSON files.

Automatic log fetching only runs for users who are opted in (enabled in your Profile Settings).

  • If you are opted in, logs are automatically fetched once every 24 hours by the background system (update_logs.php).
  • If you are not opted in, logs must be refreshed manually using the "Refresh Logs" button on the Property Logs page.

Manual refresh (available to everyone):

  • Click the "Refresh Logs" button on the Property Logs page.
  • 60‑second cooldown between refreshes (to prevent spam).
  • Works regardless of opt‑in status.

⏳ Next automatic update – if you are opted in, the system will fetch logs every 24 hours. You can see the exact next update time on your Property Logs page.

πŸ”‘ API Key Requirements – Be Exact

Different property features require different API key scopes. Here is exactly what each feature needs:

Feature Required Scope What Happens If Missing
View your properties (list, happy, upkeep, market price) properties Property data will not load.
View current rent and lease details properties Rent and lease fields will show β€”.
View lease history (logs), lifetime income, tenant history log These fields will show ⚠️ Log scope missing.
Manual refresh of logs (via "Refresh Logs" button) log The refresh will fail and show an error.

Important: The log and properties scopes are not "higher level" – they are simply scopes that you can enable or disable when generating your API key on Torn. To see full property history, your key must have both properties and log scopes enabled.

Recommended: A key with properties and log scopes enabled (or a Full Access key) for the best experience.

Need to update your key? Go to Torn API Settings and check the required boxes.

Why Might Data Be Incomplete?
  • Your API key lacks the log scope – enable it to see full history.
  • No lease history exists for the property (never rented).
  • You are not opted in (auto‑fetch disabled).
  • The cron hasn't run yet – wait up to 24 hours after opt‑in.
πŸ”„ Manual Update Instructions
  1. Go to the Property Logs page.
  2. Click the "Refresh Logs" button.
  3. Wait a few seconds – your logs will be fetched and updated.
  4. You can only refresh once per 60 seconds.

Note: Manual refresh resets the 24‑hour automatic timer if you are opted in.

πŸ“‹ Go to Property Logs