APIv2 Corp CorporationSheet XML

From EVEDev

Jump to: navigation, search
Image:Api.pngAPI Methods - Category Home - API Libraries - API Usage Examples - API Method Reference - API Page Index

Contents

[edit] /corp/CorporationSheet.xml.aspx

[edit] Overview

Returns attributes relating to a specific corporation.

[edit] Data Caching

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

[edit] Limited Key

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

[edit] Input Arguments

Name Type Description
userID int userID of account for authentication.
apiKey char(64) Limited or Full access API key of account.
characterID int characterID of character in the corporation about which you want information.

[edit] 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:

[edit] 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.

[edit] Input Arguments

Name Type Description
corporationID int ID of the corporation for which you want details
[edit] 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.

[edit] 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>
 

[edit] Output Columns

[edit] 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.
ceoName string Character Name of the CEO.
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.

[edit] Corporation Divisions rowset

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

[edit] Corporation Wallet Divisions rowset

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

[edit] Corporation Logo

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 #
Retrieved from "http://wiki.eve-id.net/APIv2_Corp_CorporationSheet_XML"
Personal tools