Battle reports API

curl.exe -H "Authorization: Bearer report_your_token_here" -F "file=@C:\Program Files (x86)\Rise of Kingdoms\Rise of Kingdoms Game\save\mailcache\Persistent.Mail.16948011179036099820" https://xerobytes.net/api/rok/battle-reports

curl -H "Authorization: Bearer report_your_token_here" \
  -F "file=@Persistent.Mail.16948011179036099820" \
  https://xerobytes.net/api/rok/battle-reports

POST /api/rok/battle-reports

{
  "accepted": 1,
  "duplicates": 1,
  "rejected": 1,
  "results": [
    {
      "file": "Persistent.Mail.16948011179036099820",
      "status": "accepted",
      "report": {
        "id": "4b0d6f7e-2f3a-4d0e-9c55-0f6f3c1e2a10",
        "foughtOn": "2026-09-25",
        "mode": "field",
        "pairings": 1,
        "createdAt": "2026-09-26T18:02:11.482113+00:00",
        "report": { "format": "xerobytes.battle/1", "...": "the whole report, see below" }
      }
    },
    { "file": "Persistent.Mail.16931114179036077320", "status": "duplicate" },
    {
      "file": "Persistent.Mail.16426540179035434620",
      "status": "rejected",
      "error": "not_a_battle_report",
      "message": "A mail, but not a battle report. Only battle reports are kept."
    }
  ]
}

GET /api/rok/battle-reports?limit=50&mode=field&since=2026-09-01

{
  "reports": [
    { "id": "4b0d6f7e-...", "foughtOn": "2026-09-25", "mode": "field", "pairings": 1,
      "createdAt": "2026-09-26T18:02:11.482113+00:00", "report": { "format": "xerobytes.battle/1", "...": "..." } }
  ],
  "nextCursor": "WyIyMDI2LTA5LTI2VDE4OjAyOjExLjQ4MjExMyswMDowMCIsIjRiMGQ2ZjdlLTJmM2EtNGQwZS05YzU1LTBmNmYzYzFlMmExMCJd"
}

GET    /api/rok/battle-reports/{id}
DELETE /api/rok/battle-reports/{id}

curl -X DELETE -H "Authorization: Bearer report_your_token_here" \
  https://xerobytes.net/api/rok/battle-reports/4b0d6f7e-2f3a-4d0e-9c55-0f6f3c1e2a10

{ "error": "rate_limited", "message": "Too many requests for this account. Wait 12 seconds and send it again.", "retry_after": 12 }

{
  "format": "xerobytes.battle/1",
  "foughtOn": "2026-09-25",
  "durationSeconds": 32,
  "kvk": true,
  "mode": "field",
  "scene": "gsmp",
  "you": {
    "primary": {
      "heroId": 141, "slug": "thutmose", "level": 60, "stars": 6, "awakened": false,
      "skills": [5, 5, 5, 1], "expertise": false, "awakenedSkill": null, "unplacedSkills": []
    },
    "secondary": {
      "heroId": 6, "slug": "yi-seong-gye", "level": 50, "stars": 5, "awakened": true,
      "skills": [5, 5, 5, 5], "expertise": true, "awakenedSkill": null, "unplacedSkills": []
    },
    "equipment": [{ "slot": 1, "item": 20060, "code": 0, "iconic": 0 }, { "slot": 3, "item": 20021, "code": 21, "iconic": 1 }],
    "formation": null, "armaments": [], "watchtower": null, "morale": 0,
    "assistSkills": [], "supportSkills": [], "rally": false, "structure": false,
    "participants": [{ "primary": { "heroId": 141, "slug": "thutmose", "level": 60 },
                       "secondary": { "heroId": 6, "slug": "yi-seong-gye", "level": 50 } }]
  },
  "engagements": [
    {
      "opponent": {
        "kind": "player", "npc": null,
        "primary": { "heroId": 7, "slug": "cao-cao", "level": 60, "...": "as above" },
        "secondary": { "heroId": 99, "slug": "aethelflaed", "level": 47, "...": "as above" },
        "equipment": [{ "slot": 1, "item": 20100, "code": 0, "iconic": 0 }], "...": "the rest of a setup"
      },
      "start": 0, "end": 31, "rounds": 32, "result": "win",
      "losses": {
        "you": {
          "troops": 210000, "marchSize": 210000, "remaining": 192780,
          "dead": 0, "severelyWounded": 6640, "slightlyWounded": 10580, "healed": 0,
          "killPoints": 788470, "powerLost": 66400,
          "powerLostToAttacks": 48790, "powerLostToSkills": 17610,
          "reinforcementsJoined": 0, "reinforcementsLeft": 0, "watchtower": null, "tier": 5
        },
        "opponent": { "troops": 180000, "remaining": 0, "severelyWounded": 78847, "tier": 4, "...": "as above" }
      }
    }
  ],
  "totals": null,
  "troopsOverTime": [[0, 210000], [31, 192780]],
  "reinforcements": []
}

# Upload every mail in the folder, 50 files a request. Windows PowerShell 5.1 or later.
$token  = "report_your_token_here"
$folder = "C:\Program Files (x86)\Rise of Kingdoms\Rise of Kingdoms Game\save\mailcache"
$files  = Get-ChildItem -Path $folder -Filter "Persistent.Mail.*" -File |
          Where-Object { $_.Length -le 262144 }

for ($i = 0; $i -lt $files.Count; $i += 50) {
    $batch = $files[$i..([Math]::Min($i + 49, $files.Count - 1))]
    $form  = $batch | ForEach-Object { "-F"; "file=@$($_.FullName)" }
    curl.exe --silent --show-error `
        -H "Authorization: Bearer $token" @form `
        https://xerobytes.net/api/rok/battle-reports
    Start-Sleep -Seconds 3
}

import pathlib, time, requests

TOKEN = "report_your_token_here"
URL = "https://xerobytes.net/api/rok/battle-reports"
folder = pathlib.Path(r"C:\Program Files (x86)\Rise of Kingdoms\Rise of Kingdoms Game\save\mailcache")
files = [p for p in folder.glob("Persistent.Mail.*") if p.stat().st_size <= 262144]

for start in range(0, len(files), 50):
    batch = files[start:start + 50]
    while True:
        r = requests.post(
            URL,
            headers={"Authorization": f"Bearer {TOKEN}"},
            files=[("file", (p.name, p.read_bytes())) for p in batch],
            timeout=60,
        )
        if r.status_code != 429:
            break
        time.sleep(int(r.headers.get("Retry-After", "10")))
    r.raise_for_status()
    body = r.json()
    print(f"{body['accepted']} new, {body['duplicates']} already on file, {body['rejected']} refused")

// Node 18 or later: fetch, FormData and Blob are built in.
import { readdir, readFile, stat } from 'node:fs/promises';
import { join } from 'node:path';

const TOKEN = 'report_your_token_here';
const URL = 'https://xerobytes.net/api/rok/battle-reports';
const folder = 'C:/Program Files (x86)/Rise of Kingdoms/Rise of Kingdoms Game/save/mailcache';

const names = (await readdir(folder)).filter((n) => n.startsWith('Persistent.Mail.'));
for (let i = 0; i < names.length; i += 50) {
  const form = new FormData();
  for (const name of names.slice(i, i + 50)) {
    const path = join(folder, name);
    if ((await stat(path)).size > 262144) continue;
    form.append('file', new Blob([await readFile(path)]), name);
  }
  const res = await fetch(URL, { method: 'POST', headers: { Authorization: `Bearer ${TOKEN}` }, body: form });
  if (res.status === 429) {
    await new Promise((r) => setTimeout(r, Number(res.headers.get('retry-after') ?? 10) * 1000));
    i -= 50;
    continue;
  }
  const body = await res.json();
  console.log(`${body.accepted} new, ${body.duplicates} already on file, ${body.rejected} refused`);
}

curl -H "Authorization: Bearer report_your_token_here" \
  -H "Content-Type: application/octet-stream" \
  -H "X-File-Name: Persistent.Mail.16948011179036099820" \
  --data-binary @Persistent.Mail.16948011179036099820 \
  https://xerobytes.net/api/rok/battle-reports

cursor=""
while :; do
  page=$(curl -s -H "Authorization: Bearer report_your_token_here" \
    "https://xerobytes.net/api/rok/battle-reports?limit=100${cursor:+&cursor=$cursor}")
  echo "$page" | jq -c '.reports[] | {foughtOn, mode, id}'
  cursor=$(echo "$page" | jq -r '.nextCursor // empty')
  [ -z "$cursor" ] && break
done