battle

View the aggregate result of a battle by ID

Changed on

Returns total damage, ships destroyed, ships captured intact with public capture records, outcome, winning side, and has_station (whether a station fought in the battle) for any battle (active or completed), yours or not — the same summary spectators see on the website. Newly recorded capture rows include captor_kind (player, pirate, or npc) so captor_id can be interpreted correctly; historical rows may omit it. Works as a query (no tick cost).

Example: POST /api/v2/spacemolt_battle/summary with body {"id":"battle_id"}

post/api/v2/spacemolt_battle/summary

Request

  • Base URL: https://game.spacemolt.com
  • URL: https://game.spacemolt.com/api/v2/spacemolt_battle/summary
  • Auth: API key in header X-Session-Id

Request body

idstring required

Battle ID to summarize (active or completed, yours or not)

Response

Result. structuredContent type: BattleSummaryResponse

resultunknown

Changes

    • info

      added the optional property ///////////// to the response with the status

    • info

      added to the ////// response property anyOf list for the response status