Read app logs through the API

Pull your app's logins, page views, emails, sessions, record changes, webhooks, backups and other logs into your own tools, 50 entries at a time.

  • Verified Nov 17, 2026
  • Classic builder

On this page
  1. Before you start
  2. Pages of results
  3. The log endpoints
  4. Filters
  5. Keep the key safe

The Logs API returns the same logs you see in the builder, so you can feed them into a security dashboard, an audit archive or an alert. Every log endpoint is read-only.

Before you start #

  • Your plan must include API access and logs through the API (the Allow Logs switch shows a plan icon when it does not).
  • Turn on Allow Logs on the API key in Settings > API Keys. Without it, calls answer 412 with "The method being used is disabled for this API key."
  • Every URL starts with https://api.tadabase.io/api/v1/logs/.
The API key form in Settings with the Allow Logs switch highlighted

Pages of results #

Every log endpoint returns 50 entries per call, newest first. Add ?page=2, ?page=3 and so on for older entries. The page size cannot be changed and there is no date filter: to collect everything since your last run, read pages until you reach an entry you already have.

JSON
{
  "total_items": 1240,
  "page": 1,
  "total_pages": 25,
  "items": [ ... ],
  "type": "success"
}

If a log store is briefly unreachable, the answer is type: error with "Logs are temporarily unavailable. Please try again in a few minutes." Retry later.

The log endpoints #

EndpointWhat it returnsProperties of each entry
logs/loginsSuccessful app user loginsemail, name, type, created_at, ip, address, address2, city, state, country, zip, latitude, longitude, platform, browser, device, device_type
logs/failed-loginsFailed login attemptscreated_at, username, ip, city, state, country, platform, browser, device, device_type
logs/sessionsApp user sessions started in the last 13 hours that have not expiredemail, name, created_at, expire_at, last_active_at, browser, ip
logs/blocked-usersBlocked app userstype, created_at, username, start_at, end_at, status
logs/blocked-ipsBlocked IP addressestype, created_at, username, start_at, end_at, status
logs/page-viewsPages viewed in the live appurl, page_id, created_at, ip, browser, app_user_id, user (name and email, or "Not Logged in")
logs/emailsEmails the app sentunique_id, created_at, to, subject, status, body, from_email, from_name, browser, ip
logs/builder-activitiesChanges made in the buildertype, created_at, ip, user (name, email), metas (a list of name and val)
logs/record-logsRecord changesid, created_at, data_table_id, record_id, ip, url, method, source, source2, duration
logs/deleted-record-logsDeleted recordsid, created_at, data_table_id, record_id, ip, url, method, source, source2, duration
logs/import-logsImportsid, name, import_template_id, metas, created_at, created_by
logs/webhook-logsOutgoing webhook callsid, created_at, webhook_id, data_table_id, record_id, target_url, error, status
logs/file-upload-logsFiles uploaded to the appid, url, size, type, created_at, created_by, data_table_id, record_id, field_id, status, deleted_by, file_name, ext, secured, disk
logs/file-access-logsOpens of secured filesid, created_at, created_by, source, file_upload_id, record_id, data_table_id, field_id, field_slug, page_id, url, ip, region, city, country, timezone, browser, platform, device_type, device
logs/backupsApp backupsbackup_id, created_at, start_at, end_at, status, origin, total_tables, file_size_bytes, total_backup_time, backup_type, s3_path, created_by (name, email, or "System")
logs/restoresRestores from a backuprestore_id, backup_id, created_at, start_at, end_at, status, origin, restore_type, total_tables, file_size_bytes, total_time, s3_path, created_by
logs/api-logsCalls made to the APIid, created_at, app_key_id, duration (seconds), ip, url, method
logs/api-daily-usagesAPI calls per key per dayid, date, api_key_id, total_request, last_used_date, created_at

Backup and restore times are shown in the app's time zone.

Filters #

A few endpoints take query parameters to narrow the list. Use the values exactly as these logs return them.

EndpointQuery parameters
logs/record-logs, logs/deleted-record-logsdata_table_id, record_id, source
logs/webhook-logswebhook_id, data_table_id, record_id, status
logs/file-access-logsrecord_id, field_id, file_upload_id, data_table_id, source
logs/api-logsmethod (for example GET or POST)
logs/api-daily-usagesdate, api_key_id
Shell
curl "https://api.tadabase.io/api/v1/logs/webhook-logs?status=error&page=1" \
  -H "X-Tadabase-App-Id: YOUR_APP_ID" \
  -H "X-Tadabase-App-Key: YOUR_API_KEY" \
  -H "X-Tadabase-App-Secret: YOUR_API_SECRET"

Keep the key safe #

Logs hold email addresses, IP addresses, email bodies and locations. Give Allow Logs only to a key that needs it, keep that key on your server, and store what you collect as carefully as the app's own data. Each log call also counts toward your API rate limits (see Rate limiting).

Was this page helpful?

Something wrong or missing on this page? Tell us.