Skip to main content
Documentation

Data Export

Download your match results as a ZIP of two spreadsheets: one row per match you played, and one row per game in those matches. Use it for your own records, for spreadsheet analysis, or to take your history to another tool.

Free for everyone

Exporting your own data is part of your rights under GDPR Article 20 and the CCPA. Every signed-in player can use it, and no plan or setting turns it off.

What you get

Each export is a ZIP file named tabletop-league-results-<date>.zip containing:

FileContents
matches.csvOne row per completed match you played, newest first.
games.csvOne row per game in those matches.
README.txtA short guide to the columns. The tables below say the same.

The export holds completed matches only. Scheduled, in-progress and cancelled matches are left out. Matches you played as part of a party or team are included. Your private friendlies are included too, since you played them.

matches.csv

ColumnMeaning
match_idJoins to games.csv.
dateWhen the match was completed, in ISO 8601 UTC (2026-10-20T18:30:00Z).
gameThe game system.
eventThe competition name, or Friendly for a friendly.
opponentYour opponent's display name. In a pod, every opponent, separated by ; . Empty for a bye.
resultwin, loss or draw. In a pod, your placement (2nd of 4). no result for a forfeit nobody won.
your_scoreGames you won. In a pod, your points.
opponent_scoreGames your opponent won. Empty in a pod.
forfeityes when the match was decided by a forfeit or was a bye.
match_urlA link to the match page.

games.csv

ColumnMeaning
match_idJoins to matches.csv.
game_number1, 2, 3 and so on, within the match.
your_fighterWhat you played, as it was reported. Several picks are joined with +.
opponent_fighterWhat your opponent played.
mapThe map, when one was reported.
resultwin or loss.
concededyes when that game was conceded.

Opponents

Opponents appear under the display name their profile shows on the site: their preferred name, or their username, or the name they entered the event under. The export never includes an opponent's real name, email address, Discord, Google, Twitch or YouTube account, country, timezone, avatar or account ID.

What's not in the export

  • Matches you didn't play
  • Other players' profiles, stats or matches
  • Ratings, standings, leaderboards and other statistics
  • Competition settings and internal IDs
  • Chat, comments and notification history

How to export

  1. Sign in.
  2. Open Settings → Data.
  3. Select Download my results.
  4. The ZIP downloads after a few seconds.

The file is built on request and sent straight to your browser. We don't keep a copy.

Limits

  • 3 exports per 24 hours. This protects the export service. It doesn't limit your access to your own data. If you need more, contact us.
  • Your 5,000 most recent completed matches and every game in them. The cap counts matches, not rows: games.csv holds every game of those 5,000 matches. If you've played more, the README says so.
  • The CSVs are UTF-8 (with a byte-order mark, so Excel reads accented names correctly), comma-separated, with RFC 4180 quoting. Excel, Numbers, Google Sheets and LibreOffice open them without any setup.

Your data rights

Under GDPR (EU) and the CCPA (California) you can get your personal data in a structured, machine-readable format. These CSVs meet that. You can:

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

The export also names the people you played. Per the API terms, please don't publish other players' data, look them up in other systems, or use the export to build a dataset about other players.

Frequently asked

Is the export free? Yes, for every signed-in player. The Personal API is a separate, programmatic product, and the export doesn't depend on it.

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

What if I delete my account? Export your data first, because the export button goes away with your account. Account deletion is a separate flow you run yourself from Settings → Account. It deletes your profile, email and sign-in links, and anonymizes your part in shared records (your matches still show a result, against "Deleted Player"), so your opponents' histories stay intact. You get a 30-day grace period: signing back in within 30 days cancels the deletion, and after that it's permanent. See Your Profile for what's kept and what's deleted.

Can I re-import the export? No. It's a record of your results for you to keep, not a backup we can restore from.

Why CSV and not JSON? CSV opens in every spreadsheet tool without any setup.