EVE Online Corporation API

openapi: 3.0.0
info:
  description: An OpenAPI for EVE Online
  title: EVE Swagger Interface Alliance Corporation API
  version: '1.36'
servers:
- url: https://esi.evetech.net/latest
tags:
- name: Corporation
paths:
  /corporations/npccorps/:
    get:
      description: 'Get a list of npc corporations


        ---

        Alternate route: `/dev/corporations/npccorps/`


        Alternate route: `/legacy/corporations/npccorps/`


        Alternate route: `/v1/corporations/npccorps/`


        Alternate route: `/v2/corporations/npccorps/`


        ---

        This route expires daily at 11:05'
      operationId: get_corporations_npccorps
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: A list of npc corporation ids
          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_corporations_npccorps_200_ok
                  type: integer
                maxItems: 500
                title: get_corporations_npccorps_ok
                type: array
              examples:
                response:
                  value:
                  - 1000001
                  - 1000002
                  - 1000003
        '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 Get Npc Corporations
      tags:
      - Corporation
      x-alternate-versions:
      - dev
      - legacy
      - v1
      - v2
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /corporations/{corporation_id}/:
    get:
      description: 'Public information about a corporation


        ---

        Alternate route: `/dev/corporations/{corporation_id}/`


        Alternate route: `/legacy/corporations/{corporation_id}/`


        Alternate route: `/v4/corporations/{corporation_id}/`


        Alternate route: `/v5/corporations/{corporation_id}/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_corporations_corporation_id
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: Public information about a corporation
          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:
                  alliance_id:
                    description: ID of the alliance that corporation is a member of, if any
                    format: int32
                    title: get_corporations_corporation_id_alliance_id
                    type: integer
                  ceo_id:
                    description: ceo_id integer
                    format: int32
                    title: get_corporations_corporation_id_ceo_id
                    type: integer
                  creator_id:
                    description: creator_id integer
                    format: int32
                    title: get_corporations_corporation_id_creator_id
                    type: integer
                  date_founded:
                    description: date_founded string
                    format: date-time
                    title: get_corporations_corporation_id_date_founded
                    type: string
                  description:
                    description: description string
                    title: get_corporations_corporation_id_description
                    type: string
                  faction_id:
                    description: faction_id integer
                    format: int32
                    title: get_corporations_corporation_id_faction_id
                    type: integer
                  home_station_id:
                    description: home_station_id integer
                    format: int32
                    title: get_corporations_corporation_id_home_station_id
                    type: integer
                  member_count:
                    description: member_count integer
                    format: int32
                    title: get_corporations_corporation_id_member_count
                    type: integer
                  name:
                    description: the full name of the corporation
                    title: get_corporations_corporation_id_name
                    type: string
                  shares:
                    description: shares integer
                    format: int64
                    title: get_corporations_corporation_id_shares
                    type: integer
                  tax_rate:
                    description: tax_rate number
                    format: float
                    maximum: 1
                    minimum: 0
                    title: get_corporations_corporation_id_tax_rate
                    type: number
                  ticker:
                    description: the short name of the corporation
                    title: get_corporations_corporation_id_ticker
                    type: string
                  url:
                    description: url string
                    title: get_corporations_corporation_id_url
                    type: string
                  war_eligible:
                    description: war_eligible boolean
                    title: get_corporations_corporation_id_war_eligible
                    type: boolean
                required:
                - name
                - ticker
                - member_count
                - ceo_id
                - tax_rate
                - creator_id
                title: get_corporations_corporation_id_ok
                type: object
              examples:
                response:
                  value:
                    alliance_id: 434243723
                    ceo_id: 180548812
                    creator_id: 180548812
                    date_founded: 2004-11-28 16:42:51+00:00
                    description: This is a corporation description, it's basically just a string
                    member_count: 656
                    name: C C P
                    tax_rate: 0.256
                    ticker: -CCP-
                    url: http://www.eveonline.com
        '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
        '404':
          description: Corporation not found
          content:
            application/json:
              schema:
                description: Not found
                properties:
                  error:
                    description: Not found message
                    title: get_corporations_corporation_id_404_not_found
                    type: string
                title: get_corporations_corporation_id_not_found
                type: object
              examples:
                response:
                  value:
                    error: Not found 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 Get Corporation Information
      tags:
      - Corporation
      x-alternate-versions:
      - dev
      - legacy
      - v4
      - v5
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /corporations/{corporation_id}/alliancehistory/:
    get:
      description: 'Get a list of all the alliances a corporation has been a member of


        ---

        Alternate route: `/dev/corporations/{corporation_id}/alliancehistory/`


        Alternate route: `/legacy/corporations/{corporation_id}/alliancehistory/`


        Alternate route: `/v2/corporations/{corporation_id}/alliancehistory/`


        Alternate route: `/v3/corporations/{corporation_id}/alliancehistory/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_corporations_corporation_id_alliancehistory
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: Alliance history for the given corporation
          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 object
                  properties:
                    alliance_id:
                      description: alliance_id integer
                      format: int32
                      title: get_corporations_corporation_id_alliancehistory_alliance_id
                      type: integer
                    is_deleted:
                      description: True if the alliance has been closed
                      title: get_corporations_corporation_id_alliancehistory_is_deleted
                      type: boolean
                    record_id:
                      description: An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous
                      format: int32
                      title: get_corporations_corporation_id_alliancehistory_record_id
                      type: integer
                    start_date:
                      description: start_date string
                      format: date-time
                      title: get_corporations_corporation_id_alliancehistory_start_date
                      type: string
                  required:
                  - start_date
                  - record_id
                  title: get_corporations_corporation_id_alliancehistory_200_ok
                  type: object
                maxItems: 10000
                title: get_corporations_corporation_id_alliancehistory_ok
                type: array
              examples:
                response:
                  value:
                  - alliance_id: 99000006
                    is_deleted: true
                    record_id: 23
                    start_date: 2016-10-25 14:46:00+00:00
                  - record_id: 1
                    start_date: 2015-07-06 20:56:00+00:00
        '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 Get Alliance History
      tags:
      - Corporation
      x-alternate-versions:
      - dev
      - legacy
      - v2
      - v3
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /corporations/{corporation_id}/blueprints/:
    get:
      description: 'Returns a list of blueprints the corporation owns


        ---

        Alternate route: `/dev/corporations/{corporation_id}/blueprints/`


        Alternate route: `/legacy/corporations/{corporation_id}/blueprints/`


        Alternate route: `/v2/corporations/{corporation_id}/blueprints/`


        Alternate route: `/v3/corporations/{corporation_id}/blueprints/`


        ---

        This route is cached for up to 3600 seconds


        ---

        Requires one of the following EVE corporation role(s): Director

        '
      operationId: get_corporations_corporation_id_blueprints
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: List of corporation blueprints
          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:
                    item_id:
                      description: Unique ID for this item.
                      format: int64
                      title: get_corporations_corporation_id_blueprints_item_id
                      type: integer
                    location_flag:
                      description: Type of the location_id
                      enum:
                      - AssetSafety
                      - AutoFit
                      - Bonus
                      - Booster
                      - BoosterBay
                      - Capsule
                      - CapsuleerDeliveries
                      - Cargo
                      - CorpDeliveries
                      - CorpSAG1
                      - CorpSAG2
                      - CorpSAG3
                      - CorpSAG4
                      - CorpSAG5
                      - CorpSAG6
                      - CorpSAG7
                      - CorporationGoalDeliveries
                      - CrateLoot
                      - Deliveries
                      - DroneBay
                      - DustBattle
                      - DustDatabank
                      - FighterBay
                      - FighterTube0
                      - FighterTube1
                      - FighterTube2
                      - FighterTube3
                      - FighterTube4
                      - FleetHangar
                      - FrigateEscapeBay
                      - Hangar
                      - HangarAll
                      - HiSlot0
                      - HiSlot1
                      - HiSlot2
                      - HiSlot3
                      - HiSlot4
                      - HiSlot5
                      - HiSlot6
                      - HiSlot7
                      - HiddenModifiers
                      - Implant
                      - Impounded
                      - InfrastructureHangar
                      - JunkyardReprocessed
                      - JunkyardTrashed
                      - LoSlot0
                      - LoSlot1
                      - LoSlot2
                      - LoSlot3
                      - LoSlot4
                      - LoSlot5
                      - LoSlot6
                      - LoSlot7
                      - Locked
                      - MedSlot0
                      - MedSlot1
                      - MedSlot2
                      - MedSlot3
                      - MedSlot4
                      - MedSlot5
                      - MedSlot6
                      - MedSlot7
                      - MobileDepotHold
                      - MoonMaterialBay
                      - OfficeFolder
                      - Pilot
                      - PlanetSurface
                      - QuafeBay
                      - QuantumCoreRoom
                      - Reward
                      - RigSlot0
                      - RigSlot1
                      - RigSlot2
                      - RigSlot3
                      - RigSlot4
                      - RigSlot5
                      - RigSlot6
                      - RigSlot7
                      - SecondaryStorage
                      - ServiceSlot0
                      - ServiceSlot1
                      - ServiceSlot2
                      - ServiceSlot3
                      - ServiceSlot4
                      - ServiceSlot5
                      - ServiceSlot6
                      - ServiceSlot7
                      - ShipHangar
                      - ShipOffline
                      - Skill
                      - SkillInTraining
                      - SpecializedAmmoHold
                      - SpecializedAsteroidHold
                      - SpecializedCommandCenterHold
                      - SpecializedFuelBay
                      - SpecializedGasHold
                      - SpecializedIceHold
                      - SpecializedIndustrialShipHold
                      - SpecializedLargeShipHold
                      - SpecializedMaterialBay
                      - SpecializedMediumShipHold
                      - SpecializedMineralHold
                      - SpecializedOreHold
                      - SpecializedPlanetaryCommoditiesHold
                      - SpecializedSalvageHold
                      - SpecializedShipHold
                      - SpecializedSmallShipHold
                      - StructureActive
                      - StructureFuel
                      - StructureInactive
                      - StructureOffline
                      - SubSystemBay
                      - SubSystemSlot0
                      - SubSystemSlot1
                      - SubSystemSlot2
                      - SubSystemSlot3
                      - SubSystemSlot4
                      - SubSystemSlot5
                      - SubSystemSlot6
                      - SubSystemSlot7
                      - Unlocked
                      - Wallet
                      - Wardrobe
                      title: get_corporations_corporation_id_blueprints_location_flag
                      type: string
                    location_id:
                      description: References a station, a ship or an item_id if this blueprint is located within a container.
                      format: int64
                      title: get_corporations_corporation_id_blueprints_location_id
                      type: integer
                    material_efficiency:
                      description: Material Efficiency Level of the blueprint.
                      format: int32
                      maximum: 25
                      minimum: 0
                      title: get_corporations_corporation_id_blueprints_material_efficiency
                      type: integer
                    quantity:
                      description: A range of numbers with a minimum of -2 and no maximum value where -1 is an original and -2 is a copy. It can be a positive integer if it is a stack of blueprint originals fresh from the market (e.g. no activities performed on them yet).
                      format: int32
                      minimum: -2
                      title: get_corporations_corporation_id_blueprints_quantity
                      type: integer
                    runs:
                      description: Number of runs remaining if the blueprint is a copy, -1 if it is an original.
                      format: int32
                      minimum: -1
                      title: get_corporations_corporation_id_blueprints_runs
                      type: integer
                    time_efficiency:
                      description: Time Efficiency Level of the blueprint.
                      format: int32
                      maximum: 20
                      minimum: 0
                      title: get_corporations_corporation_id_blueprints_time_efficiency
                      type: integer
                    type_id:
                      description: type_id integer
                      format: int32
                      title: get_corporations_corporation_id_blueprints_type_id
                      type: integer
                  required:
                  - item_id
                  - type_id
                  - location_id
                  - location_flag
                  - quantity
                  - time_efficiency
                  - material_efficiency
                  - runs
                  title: get_corporations_corporation_id_blueprints_200_ok
                  type: object
                maxItems: 1000
                title: get_corporations_corporation_id_blueprints_ok
                type: array
              examples:
                response:
                  value:
                  - item_id: 1000000010495
                    location_flag: CorpSAG1
                    location_id: 60014719
                    material_efficiency: 0
                    quantity: 1
                    runs: -1
                    time_efficiency: 0
                    type_id: 691
        '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
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized'
              examples:
                response:
                  value:
                    error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden'
              examples:
                response:
                  value:
                    error: Forbidden 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
      security:
      - evesso:
        - esi-corporations.read_blueprints.v1
      summary: EVE Online Get Corporation Blueprints
      tags:
      - Corporation
      x-alternate-versions:
      - dev
      - legacy
      - v2
      - v3
      x-cached-seconds: 3600
      x-required-roles:
      - Director
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /corporations/{corporation_id}/containers/logs/:
    get:
      description: 'Returns logs recorded in the past seven days from all audit log secure containers (ALSC) owned by a given corporation


        ---

        Alternate route: `/dev/corporations/{corporation_id}/containers/logs/`


        Alternate route: `/legacy/corporations/{corporation_id}/containers/logs/`


        Alternate route: `/v2/corporations/{corporation_id}/containers/logs/`


        Alternate route: `/v3/corporations/{corporation_id}/containers/logs/`


        ---

        This route is cached for up to 600 seconds


        ---

        Requires one of the following EVE corporation role(s): Director

        '
      operationId: get_corporations_corporation_id_containers_logs
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: List of corporation ALSC logs
          headers:
       

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