EVE Online Wars API

openapi: 3.2.0
info:
  title: Eve Online Wars API
  version: '1.36'
  description: 'Operations tagged Wars across 7 of this provider''s published API definitions: eve-online-openapi.yml, swagger.json, swagger_2.json, swagger_3.json, swagger_4.json, swagger_5.json, swagger_6.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://esi.evetech.net/latest
- url: https://esi.evetech.net
- url: https://esi.evetech.net/legacy
- url: https://esi.evetech.net/dev
tags:
- name: Wars
paths:
  /wars/:
    get:
      description: 'Return a list of wars


        ---

        Alternate route: `/dev/wars/`


        Alternate route: `/legacy/wars/`


        Alternate route: `/v1/wars/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_wars
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - description: Only return wars with ID smaller than this
        in: query
        name: max_war_id
        required: false
        schema:
          type: integer
          format: int32
        example: 28332
      responses:
        '200':
          description: A list of war IDs, in descending order by war_id
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok array
                items:
                  description: 200 ok integer
                  format: int32
                  title: get_wars_200_ok
                  type: integer
                maxItems: 2000
                title: get_wars_ok
                type: array
              examples:
                response:
                  value:
                  - 3
                  - 2
                  - 1
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      summary: EVE Online List Wars
      tags:
      - Wars
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /wars/{war_id}/:
    get:
      description: 'Return details about a war


        ---

        Alternate route: `/dev/wars/{war_id}/`


        Alternate route: `/legacy/wars/{war_id}/`


        Alternate route: `/v1/wars/{war_id}/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_wars_war_id
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - description: ID for a war
        in: path
        name: war_id
        required: true
        schema:
          type: integer
          format: int32
          minimum: 1
        example: 28332
      responses:
        '200':
          description: Details about a war
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  aggressor:
                    description: The aggressor corporation or alliance that declared this war, only contains either corporation_id or alliance_id
                    properties:
                      alliance_id:
                        description: Alliance ID if and only if the aggressor is an alliance
                        format: int32
                        title: get_wars_war_id_alliance_id
                        type: integer
                      corporation_id:
                        description: Corporation ID if and only if the aggressor is a corporation
                        format: int32
                        title: get_wars_war_id_corporation_id
                        type: integer
                      isk_destroyed:
                        description: ISK value of ships the aggressor has destroyed
                        format: float
                        title: get_wars_war_id_isk_destroyed
                        type: number
                      ships_killed:
                        description: The number of ships the aggressor has killed
                        format: int32
                        title: get_wars_war_id_ships_killed
                        type: integer
                    required:
                    - ships_killed
                    - isk_destroyed
                    title: get_wars_war_id_aggressor
                    type: object
                  allies:
                    description: allied corporations or alliances, each object contains either corporation_id or alliance_id
                    items:
                      description: ally object
                      properties:
                        alliance_id:
                          description: Alliance ID if and only if this ally is an alliance
                          format: int32
                          title: get_wars_war_id_ally_alliance_id
                          type: integer
                        corporation_id:
                          description: Corporation ID if and only if this ally is a corporation
                          format: int32
                          title: get_wars_war_id_ally_corporation_id
                          type: integer
                      title: get_wars_war_id_ally
                      type: object
                    maxItems: 10000
                    title: get_wars_war_id_allies
                    type: array
                  declared:
                    description: Time that the war was declared
                    format: date-time
                    title: get_wars_war_id_declared
                    type: string
                  defender:
                    description: The defending corporation or alliance that declared this war, only contains either corporation_id or alliance_id
                    properties:
                      alliance_id:
                        description: Alliance ID if and only if the defender is an alliance
                        format: int32
                        title: get_wars_war_id_defender_alliance_id
                        type: integer
                      corporation_id:
                        description: Corporation ID if and only if the defender is a corporation
                        format: int32
                        title: get_wars_war_id_defender_corporation_id
                        type: integer
                      isk_destroyed:
                        description: ISK value of ships the defender has killed
                        format: float
                        title: get_wars_war_id_defender_isk_destroyed
                        type: number
                      ships_killed:
                        description: The number of ships the defender has killed
                        format: int32
                        title: get_wars_war_id_defender_ships_killed
                        type: integer
                    required:
                    - ships_killed
                    - isk_destroyed
                    title: get_wars_war_id_defender
                    type: object
                  finished:
                    description: Time the war ended and shooting was no longer allowed
                    format: date-time
                    title: get_wars_war_id_finished
                    type: string
                  id:
                    description: ID of the specified war
                    format: int32
                    title: get_wars_war_id_id
                    type: integer
                  mutual:
                    description: Was the war declared mutual by both parties
                    title: get_wars_war_id_mutual
                    type: boolean
                  open_for_allies:
                    description: Is the war currently open for allies or not
                    title: get_wars_war_id_open_for_allies
                    type: boolean
                  retracted:
                    description: Time the war was retracted but both sides could still shoot each other
                    format: date-time
                    title: get_wars_war_id_retracted
                    type: string
                  started:
                    description: Time when the war started and both sides could shoot each other
                    format: date-time
                    title: get_wars_war_id_started
                    type: string
                required:
                - id
                - declared
                - mutual
                - open_for_allies
                - aggressor
                - defender
                title: get_wars_war_id_ok
                type: object
              examples:
                response:
                  value:
                    aggressor:
                      corporation_id: 986665792
                      isk_destroyed: 0
                      ships_killed: 0
                    declared: 2004-05-22 05:20:00+00:00
                    defender:
                      corporation_id: 1001562011
                      isk_destroyed: 0
                      ships_killed: 0
                    id: 1941
                    mutual: false
                    open_for_allies: false
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '422':
          description: War not found
          content:
            application/json:
              schema:
                description: Unprocessable entity
                properties:
                  error:
                    description: Unprocessable entity message
                    title: get_wars_war_id_422_unprocessable_entity
                    type: string
                title: get_wars_war_id_unprocessable_entity
                type: object
              examples:
                response:
                  value:
                    error: Unprocessable entity message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      summary: EVE Online Get War Information
      tags:
      - Wars
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /wars/{war_id}/killmails/:
    get:
      description: 'Return a list of kills related to a war


        ---

        Alternate route: `/dev/wars/{war_id}/killmails/`


        Alternate route: `/legacy/wars/{war_id}/killmails/`


        Alternate route: `/v1/wars/{war_id}/killmails/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_wars_war_id_killmails
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/page'
      - description: A valid war ID
        in: path
        name: war_id
        required: true
        schema:
          type: integer
          format: int32
          minimum: 1
        example: 28332
      responses:
        '200':
          description: A list of killmail IDs and hashes
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            X-Pages:
              description: Maximum page number
              schema:
                type: integer
                format: int32
                default: 1
          content:
            application/json:
              schema:
                description: 200 ok array
                items:
                  description: 200 ok object
                  properties:
                    killmail_hash:
                      description: A hash of this killmail
                      title: get_wars_war_id_killmails_killmail_hash
                      type: string
                    killmail_id:
                      description: ID of this killmail
                      format: int32
                      title: get_wars_war_id_killmails_killmail_id
                      type: integer
                  required:
                  - killmail_id
                  - killmail_hash
                  title: get_wars_war_id_killmails_200_ok
                  type: object
                maxItems: 2000
                title: get_wars_war_id_killmails_ok
                type: array
              examples:
                response:
                  value:
                  - killmail_hash: 8eef5e8fb6b88fe3407c489df33822b2e3b57a5e
                    killmail_id: 2
                  - killmail_hash: b41ccb498ece33d64019f64c0db392aa3aa701fb
                    killmail_id: 1
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '422':
          description: War not found
          content:
            application/json:
              schema:
                description: Unprocessable entity
                properties:
                  error:
                    description: Unprocessable entity message
                    title: get_wars_war_id_killmails_422_unprocessable_entity
                    type: string
                title: get_wars_war_id_killmails_unprocessable_entity
                type: object
              examples:
                response:
                  value:
                    error: Unprocessable entity message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      summary: EVE Online List Kills for a War
      tags:
      - Wars
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /v1/wars/:
    get:
      description: 'Return a list of wars


        ---


        This route is cached for up to 3600 seconds'
      operationId: get_wars
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - description: Only return wars with ID smaller than this
        in: query
        name: max_war_id
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: A list of war IDs, in descending order by war_id
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok array
                items:
                  description: 200 ok integer
                  format: int32
                  title: get_wars_200_ok
                  type: integer
                maxItems: 2000
                title: get_wars_ok
                type: array
              example:
              - 3
              - 2
              - 1
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_2'
              example:
                error: Bad request message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited_2'
              example:
                error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error_2'
              example:
                error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable_2'
              example:
                error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout_2'
              example:
                error: Gateway timeout message
      summary: List wars
      tags:
      - Wars
      x-alternate-versions:
      - latest
      - legacy
      - v1
      x-cached-seconds: 3600
    servers:
    - url: https://esi.evetech.net
  /v1/wars/{war_id}/:
    get:
      description: 'Return details about a war


        ---


        This route is cached for up to 3600 seconds'
      operationId: get_wars_war_id
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - description: ID for a war
        in: path
        name: war_id
        required: true
        schema:
          type: integer
          format: int32
          minimum: 1
      responses:
        '200':
          description: Details about a war
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  aggressor:
                    description: The aggressor corporation or alliance that declared this war, only contains either corporation_id or alliance_id
                    properties:
                      alliance_id:
                        description: Alliance ID if and only if the aggressor is an alliance
                        format: int32
                        title: get_wars_war_id_alliance_id
                        type: integer
                      corporation_id:
                        description: Corporation ID if and only if the aggressor is a corporation
                        format: int32
                        title: get_wars_war_id_corporation_id
                        type: integer
                      isk_destroyed:
                        description: ISK value of ships the aggressor has destroyed
                        format: float
                        title: get_wars_war_id_isk_destroyed
                        type: number
                      ships_killed:
                        description: The number of ships the aggressor has killed
                        format: int32
                        title: get_wars_war_id_ships_killed
                        type: integer
                    required:
                    - ships_killed
                    - isk_destroyed
                    title: get_wars_war_id_aggressor
                    type: object
                  allies:
                    description: allied corporations or alliances, each object contains either corporation_id or alliance_id
                    items:
                      description: ally object
                      properties:
                        alliance_id:
                          description: Alliance ID if and only if this ally is an alliance
                          format: int32
                          title: get_wars_war_id_ally_alliance_id
                          type: integer
                        corporation_id:
                          description: Corporation ID if and only if this ally is a corporation
                          format: int32
                          title: get_wars_war_id_ally_corporation_id
                          type: integer
                      title: get_wars_war_id_ally
                      type: object
                    maxItems: 10000
                    title: get_wars_war_id_allies
                    type: array
                  declared:
                    description: Time that the war was declared
                    format: date-time
                    title: get_wars_war_id_declared
                    type: string
                  defender:
                    description: The defending corporation or alliance that declared this war, only contains either corporation_id or alliance_id
                    properties:
                      alliance_id:
                        description: Alliance ID if and only if the defender is an alliance
                        format: int32
                        title: get_wars_war_id_defender_alliance_id
                        type: integer
                      corporation_id:
                        description: Corporation ID if and only if the defender is a corporation
                        format: int32
                        title: get_wars_war_id_defender_corporation_id
                        type: integer
                      isk_destroyed:
                        description: ISK value of ships the defender has killed
                        format: float
                        title: get_wars_war_id_defender_isk_destroyed
                        type: number
                      ships_killed:
                        description: The number of ships the defender has killed
                        format: int32
                        title: get_wars_war_id_defender_ships_killed
                        type: integer
                    required:
                    - ships_killed
                    - isk_destroyed
                    title: get_wars_war_id_defender
                    type: object
                  finished:
                    description: Time the war ended and shooting was no longer allowed
                    format: date-time
                    title: get_wars_war_id_finished
                    type: string
                  id:
                    description: ID of the specified war
                    format: int32
                    title: get_wars_war_id_id
                    type: integer
                  mutual:
                    description: Was the war declared mutual by both parties
                    title: get_wars_war_id_mutual
                    type: boolean
                  open_for_allies:
                    description: Is the war currently open for allies or not
                    title: get_wars_war_id_open_for_allies
                    type: boolean
                  retracted:
                    description: Time the war was retracted but both sides could still shoot each other
                    format: date-time
                    title: get_wars_war_id_retracted
                    type: string
                  started:
                    description: Time when the war started and both sides could shoot each other
                    format: date-time
                    title: get_wars_war_id_started
                    type: string
                required:
                - id
                - declared
                - mutual
                - open_for_allies
                - aggressor
                - defender
                title: get_wars_war_id_ok
                type: object
              example:
                aggressor:
                  corporation_id: 986665792
                  isk_destroyed: 0
                  ships_killed: 0
                declared: '2004-05-22T05:20:00Z'
                defender:
                  corporation_id: 1001562011
                  isk_destroyed: 0
                  ships_killed: 0
                id: 1941
                mutual: false
                open_for_allies: false
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
            

# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-wars-api-openapi.yml