APIv2 Corp CorporationSheet XML

From EVEDev
Jump to: navigation, search
Api.pngAPI Methods - Category Home - API Overview - API Page Index - API Libraries - API Wanted Features

Contents

/corp/CorporationSheet.xml.aspx

Overview

Returns attributes relating to a specific corporation.

Data Caching

This method is cached according to the Modified Short Cache Style.

Limited Key

When used with the limited or full key of a character in the corporation, you get more information about the corporation.

Input Arguments

Name Type Description
KeyID int API Key ID. Must be a corporation access key
vCode char(64) API verification code

or for limited view

corporationID int Corporation ID to retrieve information for

Note: if corporation ID is supplied, API key will be ignored - you get public info even if you supply a key that allows access to the extended info.

Output XML

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2010-02-26 05:34:14</currentTime>
  <result>
    <corporationID>150212025</corporationID>
    <corporationName>Banana Republic</corporationName>
    <ticker>BR</ticker>
    <ceoID>150208955</ceoID>
    <ceoName>Mark Roled</ceoName>
    <stationID>60003469</stationID>
    <stationName>Jita IV - Caldari Business Tribunal Information Center</stationName>
    <description>Garth's testing corp of awesome sauce, win sauce as it were. In this
                 corp...&lt;br&gt;&lt;br&gt;IT HAPPENS ALL OVER</description>
    <url>some url</url>
    <allianceID>150430947</allianceID>
    <allianceName>The Dead Rabbits</allianceName>
    <taxRate>93.7</taxRate>
    <memberCount>3</memberCount>
    <memberLimit>6300</memberLimit>
    <shares>1</shares>
    <rowset name="divisions" key="accountKey" columns="accountKey,description">
      <row accountKey="1000" description="Division 1"/>
      <row accountKey="1001" description="Division 2"/>
      <row accountKey="1002" description="Division 3"/>
      <row accountKey="1003" description="Division 4"/>
      <row accountKey="1004" description="Division 5"/>
      <row accountKey="1005" description="Division 6"/>
      <row accountKey="1006" description="Division 7"/>
    </rowset>
 
    <rowset name="walletDivisions" key="accountKey" columns="accountKey,description">
      <row accountKey="1000" description="Wallet Division 1"/>
      <row accountKey="1001" description="Wallet Division 2"/>
      <row accountKey="1002" description="Wallet Division 3"/>
      <row accountKey="1003" description="Wallet Division 4"/>
      <row accountKey="1004" description="Wallet Division 5"/>
      <row accountKey="1005" description="Wallet Division 6"/>
      <row accountKey="1006" description="Wallet Division 7"/>
    </rowset>
    <logo>
      <graphicID>0</graphicID>
      <shape1>448</shape1>
      <shape2>0</shape2>
      <shape3>418</shape3>
      <color1>681</color1>
      <color2>676</color2>
      <color3>0</color3>
    </logo>
  </result>
  <cachedUntil>2010-02-26 11:34:14</cachedUntil>
</eveapi>
 

Parameters for use without an API key:

No Key

Public details of any corporation can be retrieved without an API key. Ways to get the corporationID include the alliance list and killmails.

Input Arguments

Name Type Description
corporationID int ID of the corporation for which you want details
Notes

If you pass both corporationID and the other parameters to the API server it will return the non-member version of the information just like you had only passed it corporationID.

Output XML

 
<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="1">
  <currentTime>2007-12-02 19:41:53</currentTime>
  <result>
    <corporationID>150333466</corporationID>
    <corporationName>Marcus Corp</corporationName>
    <ticker>MATT2</ticker>
    <ceoID>150302299</ceoID>
    <ceoName>Marcus</ceoName>
    <stationID>60003469</stationID>
    <stationName>Jita IV - Caldari Business Tribunal Information Center</stationName>
    <description>Another Corp</description>
    <url />
    <allianceID>150382481</allianceID>
    <allianceName>Starbase Anchoring Alliance</allianceName>
    <taxRate>0</taxRate>
    <memberCount>1</memberCount>
    <shares>1000</shares>
    <logo>
      <graphicID>0</graphicID>
      <shape1>488</shape1>
      <shape2>0</shape2>
      <shape3>0</shape3>
      <color1>0</color1>
      <color2>0</color2>
      <color3>0</color3>
    </logo>
  </result>
  <cachedUntil>2007-12-03 01:41:53</cachedUntil>
</eveapi>
 

Output Columns

Corporation Sheet

The initial data is not repetitive and is not in a rowset. Other aspects - wallets and divisions for example - are.

Name Type Description
corporationID int(10) CorporationID
corporationName string Name of the Corporation. assume varString(255)
ticker string Corp Ticker, often used as a nickname. is 6 the max length for the corp ticker?
ceoID int(10) Character ID of the CEO. This will be 1 for closed corps.
ceoName string Character Name of the CEO. This will be 'EVE System' for closed corps.
stationID int(10) Station ID of the Corporation HQ.
stationName string Station Name of the Corporation HQ.
description string Corp Description Text
url string Corporation URL.
allianceID int(10) Alliance ID, if any.
allianceName string Alliance Name, if any. Is null if not present.
taxRate string Taxes on missions and ratting. (Use varChar as datatype s it might be double).
memberCount int Current number of Members.
memberLimit int Maximum number of members based on CEO corp Management skills.
shares int Shares outstanding.

Corporation Divisions rowset

Name Type Description
accountKey small int (<10000) Division key.
description string Division (corp hangar) Label.

Corporation Wallet Divisions rowset

Name Type Description
accountKey small int Wallet ID.
description string Wallet label.

Name Type Description
graphicID int Corporation ID of the member corporation.
shape1 smallInt Shape ID #
shape2 smallInt Shape ID #
shape3 smallInt Shape ID #
color1 smallInt Color ID #
color2 smallInt Color ID #
color3 smallInt Color ID #
Personal tools