APIv2 Char Contracts XML

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

Contents

/char/Contracts.xml.aspx

Overview

Lists the personal contracts for a character.

More informations here : http://www.eveonline.com/devblog.asp?a=blog&nbid=2383

Data Caching

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

Input Arguments

Name Type Description
keyID int The ID of the Customizable API Key for authentication, found at: https://support.eveonline.com/api.
vCode char(64) The user defined or CCP generated Verification Code for the Customizable API Key, found at https://support.eveonline.com/api.
characterID int The ID of the character for the requested data, from Character List. (Only required when use keyID that works with multiple characters)
contractID long Optional - contract ID to fetch a particular contract.

Output XML

<?xml version='1.0' encoding='UTF-8'?>
<eveapi version="2">
  <currentTime>2011-07-30 04:47:30</currentTime>
  <result>
    <rowset name="contractList" key="contractID" columns="contractID,issuerID,issuerCorpID,assigneeID,acceptorID,startStationID,endStationID,
type,status,title,forCorp,dateIssued,dateExpired,dateAccepted,numDays,dateCompleted,price,reward,collateral,volume" />
  </result>
  <cachedUntil>2011-07-30 05:44:30</cachedUntil>
</eveapi>

Output Rowset Columns

Name Type Description
contractID long ? Unique ID for this contract.
issuerID long Character ID who created contract
issuerCorpID long Corporation ID who created contract
assigneeID long Character ID to whom the contract was discharged
acceptorID long Who will accept the contract. If assigneeID is same as acceptorID then CharacterID else CorporationID (The contract accepted by the corporation)
startStationID int Start station ID (for Couriers contract)
endStationID int End station ID (for Couriers contract)
type string Type of the contract (ItemExchange, Courier, Loan or Auction)
status string Status of the the contract (Outstanding, Deleted, Completed, Failed, CompletedByIssuer, CompletedByContractor, Cancelled, Rejected, Reversed or InProgress)
title string Title of the contract
forCorp int 1 if the contract was issued on behalf of the issuer's corporation, 0 otherwise
availability string Public or Private
dateIssued DateTime –°reation date of the contract
dateExpired DateTime Expiration date of the contract
dateAccepted DateTime Date of confirmation of contract
numDays int Number of days to perform the contract
dateCompleted DateTime Date of completed of contract
price float Price of contract (for ItemsExchange and Auctions)
reward float Remuneration for contract (for Couriers only)
collateral float Collateral price (for Couriers only)
buyout float Buyout price (for Auctions only)
volume float Volume of items in the contract

Sorry my English. I use Google Translate

Personal tools