WvW Insights API

Health check and feature flags. Cheap — use it to verify the service is up and to see which optional features are enabled before offering them in your UI.

{ "ok": true, "data": {
    "api_version": "1",
    "status": "ok",              // or "maintenance"
    "plugin_version": "2.5.5.6",
    "features": { "legacy_parser": true, "discord": true,
                  "highscores": true, "dpsreport": true } } }

If status is "maintenance", expect uploads to fail — surface that to your users rather than retrying.

Mint a new user token. Takes no parameters. Returns 201.

{ "ok": true, "data": { "token": "aB3xK9mN2pQ7rS4tV6wY8zC1dE" } }

Check whether a token exists — use it to validate what a user typed in before you rely on it.

{ "ok": true, "data": { "token": "aB3xK9…", "valid": true } }

A malformed or unknown token returns 200 with "valid": false — the question was well-formed, the answer is just no. It is not an error.

Reserve a new batch. No parameters. Returns 201.

{ "ok": true, "data": {
    "batch_id": "aB3xK9",
    "edit_token": "d79b7ec8bc1f427f19c754…",
    "urls": { "self": "…/batches/aB3xK9",
              "files": "…/batches/aB3xK9/files",
              "process": "…/batches/aB3xK9/process" } } }

Batches expire after 3 hours if never processed.

List what's currently staged, with the metadata the server parsed from each file. This is what you'd render on a review screen.

{ "ok": true, "data": {
    "batch_id": "aB3xK9",
    "file_count": 2,
    "files": [ { "file_id": "20260720-202900.zevtc",
                "name":    "20260720-202900.zevtc",
                "size":    501662,
                "map":     "GBL",
                "map_name": "Green Alpine Borderlands",
                "commander": "Pineapple Lonewolf",
                "recorder":  "Pineapple Lonewolf",
                "is_wvw": true } ] } }

Stage one WvW .zevtc into the batch. Send it as multipart/form-data in a field named file. One file per request. PvE or unknown-map logs are rejected and removed. Returns 201 for an accepted WvW log.

{ "ok": true, "data": {
    "file_id": "20260720-202900.zevtc",   // use this to delete it
    "name": "20260720-202900.zevtc",
    "size": 501662, "map": "GBL",
    "commander": "Pineapple Lonewolf", "is_wvw": true,
    "total_size": 501662, "remaining_size": 1073240162 } }

total_size and remaining_size are byte counts for the current batch.

A PvE or unrecognised-map upload returns HTTP 400 with error code not_wvw_log. The rejected file is not kept in the batch. If an upload would take the batch above the 1 GB total limit, it returns HTTP 413 with error code session_quota_exceeded.

Uploading the same filename twice is not an error. You get 200 with "duplicate": true and nothing is re-uploaded.

Remove one staged file before committing.

{ "ok": true, "data": { "deleted": "20260720-202900.zevtc" } }

Commit the batch. Everything currently staged gets parsed. Returns 202 Accepted immediately — the parse runs in the background.

At least two logs are required. A one-file batch is rejected with HTTP 400 and error code minimum_files.

Options can be sent as form fields or a JSON body. All are optional.

{ "ok": true, "data": {
    "batch_id": "aB3xK9",
    "job_id": "aB3xK9",          // same value — poll this
    "queued": false,
    "queue_position": 0,
    "status_url": "https://parser.rethl.net/api/v1/jobs/aB3xK9" } }

Poll a running parse. No authentication — the id is unguessable. Poll every 2–3 seconds; faster gains you nothing.

While running

{ "ok": true, "data": {
    "job_id": "aB3xK9",
    "state": "processing",
    "progress": 62,
    "component": "topstats_parsing",   // current pipeline stage
    "elapsed": 44,
    "logs": [ { "message": "Processing batch 1/1", "type": "info" } ],
    "next_log_index": 12 } }

When complete

{ "ok": true, "data": {
    "state": "complete", "progress": 100,
    "reports": [
      { "role": "main",   "name": "Report.html",
        "url": "https://output.rethl.net/aB3xK9/Report.html" },
      { "role": "legacy", "name": "LegacyReport.html", "url": "…" } ] } }

Take the report whose role is "main"; don't rely on array order or match on filenames. If component comes back as "stalled", the worker has gone quiet for over two minutes — worth surfacing to the user.

List everything a user token has parsed, newest first. Paginated.

{ "ok": true, "data": {
    "reports": [ { "id": "aB3xK9",
                  "processed_at": "2026-08-06 21:14:03",
                  "report_url": "https://output.rethl.net/aB3xK9/Report.html",
                  "legacy_report_url": null } ],
    "pagination": { "page": 1, "per_page": 20,
                    "total": 37, "total_pages": 2 } } }

Fetch a single report by its session id. No token needed — report URLs are public.

{ "ok": true, "data": {
    "report": {
        "id": "aB3xK9",
        "processed_at": "2026-08-06 21:14:03",
        "report_url": "https://output.rethl.net/20260806/aB3xK9/Report.html",
        "json_url": "https://parser.rethl.net/api/v1/reports/aB3xK9/data.json",
        "legacy_report_url": null
    } } }

Direct download / streaming endpoint for raw enriched combat summary JSON (WvW_Combat_Summary.json). You can also request GET /reports/{id}?format=json or GET /jobs/{id}/data.json.

// Returns array of tiddlers / enriched combat summary data
[
  {
    "title": "20260816-Log-Summary",
    "caption": "2026-08-16 - Squad Fight Summary",
    "tags": "2026 2026-08 summary"
  },
  ...
]