Milarki logo

Battle Endpoints

One battle in full, and the two army lists that were played in it.

Get one battle, both players included. This is the only place that gives you the round-by-round detail and the armies the players brought — the battle listings leave both out to stay small.

Path Parameters

ParameterTypeRequiredDescription
idstringRequiredThe battle id, as it appears in the battle web address.

Response Fields

idstring
The battle id. Pass it to /battles/{id}.
datestring (YYYY-MM-DD) | null
The day the battle was played, as a local date.
tournamentstring | null
Slug of the tournament the battle belongs to. Null for a casual battle.See Tournament
stagestring | null
Id of the tournament stage the battle was played in, for example "swiss". Null for a casual battle.See Stage
roundnumber | null
Round number, counting from 1.
scenariostring | null
Scenario played.
battlePackstring | null
Name of the battle pack the battle was played with.
battleSizenumber
Points limit per army, for example 2000.
winnerstring | null
Name of the winning player. Null on a draw and on a battle with no result yet.
victorySize"major" | "minor" | null
How big the win was.
playersBattlePlayer[]
The two players and how they scored.
urlstring
Link to the battle page on milarki.com.

Returns 404 if the battle does not exist.

Example response

json
{
  "data": {
    "id": "000b1161c8a864a1f75f",
    "date": "2024-03-20",
    "tournament": "nagash-testing-2024-03-20",
    "stage": "swiss",
    "round": 3,
    "scenario": "Lines of Communication",
    "battlePack": "GHB 2023-2024",
    "battleSize": 2000,
    "winner": "Anders Larsson",
    "victorySize": "major",
    "players": [
      {
        "player": "Anders Larsson",
        "playerId": "L80MTI4R",
        "faction": "Disciples of Tzeentch",
        "subFaction": "Guild of Summoners",
        "outcome": "win",
        "battlePoints": 20,
        "victoryPoints": 28,
        "objectivePoints": 18,
        "battleTacticsScored": 3,
        "grandStrategy": "Master of Destiny",
        "grandStrategyScored": false,
        "drops": 6,
        "role": "attacker",
        "metrics": {"Håll fler": 4},
        "list": {
          "faction": "Disciples of Tzeentch",
          "subFaction": "Guild of Summoners",
          "points": 1990,
          "battleTacticCards": ["Sever the Head", "Bring it Down"],
          "text": "Allegiance: Disciples of Tzeentch\n..."
        },
        "rounds": [
          {
            "round": 1,
            "victoryPoints": 3,
            "objectivePoints": 3,
            "objectives": ["Hold 1", "Primary"],
            "battleTactic": "Endless Expanse",
            "battleTacticScored": false,
            "priority": true
          }
        ]
      }
    ],
    "url": "https://www.milarki.com/battles/000b1161c8a864a1f75f"
  }
}