Data Export

Download a complete copy of your own match data as a ZIP of CSV files. Useful for personal record-keeping, spreadsheet analysis, archiving, or moving your data to another platform.

What you get

Each export is a ZIP file named tabletopleague-data-<yourId>-<date>.zip containing:

| File | Contents | | -------------------- | -------------------------------------------------------------------------------------------------------- | | matches.csv | One row per match series you participated in. Date, competition, format, status, result. | | games.csv | One row per individual game within those matches. Sequence, map, end health, winner. | | participations.csv | Your match_participants + game_participants rows. Fighter played, starting position, score. | | opponents.csv | Display names and avatars of opponents only. No email, Discord ID, real name, country, or other PII. | | README.txt | Schema explainer + privacy notice. Read this first. |

The four CSVs are normalized — you can join them on the IDs they share (match_id, game_id, opponent_id).

Opponent privacy

The opponent file is deliberately minimal. Even though you played against these people, the export doesn't tell you:

• Their email address
• Their Discord ID, Google ID, Twitch handle, or YouTube channel
• Their legal name
• Their country or timezone
• Their stable user ID

You get a per-export pseudonym (opponent_1, opponent_2, ...) so you can trace who-played-whom within your own export. The pseudonym is NOT stable across exports — exporting twice will reshuffle the numbering. This is intentional: it prevents the export from being used to build a cross-user dossier.

The same masking applies to friendly matches — you only get friendlies you were in, and opponent names in friendlies are masked to "Player" even when the field would otherwise contain a username.

What's NOT in the export

• Matches you did not participate in
• Other users' profiles, stats, or matches
• Platform-wide aggregates or leaderboards
• Match data older than the 5,000-most-recent match cap (if you have more than 5,000 matches across all time, contact us)
• Real-time chat, comments, or notification history

How to export

1. Sign in to your account.
2. Open Settings → Data.
3. Click Download my data.
4. Wait for the ZIP to generate (usually a few seconds).
5. Save the file somewhere safe.

The export runs server-side and streams a ZIP directly to your browser. We do not retain a copy.

Limits

• 3 exports per 24 hours. This is to prevent accidental hammering of the export pipeline, not to limit your access to your own data. If you genuinely need to export more often, contact us.
• 5,000 most-recent matches per export. Covers the vast majority of users. If you've played more than that, the export gives you the most recent 5,000.
• The CSVs use UTF-8 with BOM, comma-separated, RFC 4180 quoting. Standard spreadsheet tools (Excel, Numbers, Google Sheets, LibreOffice) open them without configuration.

Your data rights

Under GDPR (EU) and CCPA (California), you have the right to obtain your personal data in a structured, machine-readable format. CSV satisfies that. You can:

• Take the export with you if you leave the platform
• Share it with anyone you choose
• Re-import it into other tools

What you cannot do (per the API terms you accept when using the export):

• Re-identify masked opponents or attempt to look them up in other systems
• Redistribute or publish opponents' data
• Use the export to seed a competing platform or scrape-based dataset

These restrictions exist because the export includes information about people who haven't consented to having their data published — your opponents. Treat their masked data as confidential.

Coming with Pro

The basic export is free forever. With the upcoming Pro tier you'll also get:

• Higher daily export quota
• Programmatic access via the Personal API for scripted exports and custom dashboards
• Advanced analytics (extended-history charts, BT trends, additional fighter/opponent breakdowns)

Want to be among the first to try it? Contact us to join early access.

Frequently asked

Will Pro paywall the basic CSV export? No. Basic export stays free. Pro raises quotas and unlocks the programmatic API, but the export button on /settings/data will work for any logged-in user forever.

Can I export someone else's data? No. The export only contains matches you were a participant in. There is no admin override.

What if I delete my account? Export your data first. Account deletion is a separate flow (coming soon) that will purge your profile and anonymize your participation in shared records.

Is the export bit-exact reversible? No — opponents are masked, and we discard cache layers between the DB and the file. The export is "everything you'd want for personal records" not "a backup we can re-import."

Why no JSON option? CSV is the most universally portable format for tabular data. JSON support is on the Pro API roadmap if there's demand; the basic export stays CSV.