Get contracts - EVE Swagger Interface

Returns contracts available to a character, only if the character is issuer, acceptor or assignee. Only returns contracts no older than 30 days, or if the status is "in_progress".

Alternate route: /dev/characters/{character_id}/contracts/

Alternate route: /legacy/characters/{character_id}/contracts/

Alternate route: /v1/characters/{character_id}/contracts/

This route is cached for up to 300 seconds

[ { "acceptor_id": 0, "assignee_id": 0, "availability": "public", "buyout": 10000000000.01, "contract_id": 1, "date_accepted": "2023-08-15T09:13:17.858Z", "date_completed": "2023-08-15T09:13:17.858Z", "date_expired": "2023-08-15T09:13:17.858Z", "date_issued": "2023-08-15T09:13:17.858Z", "days_to_complete": 0, "end_location_id": 60014719, "for_corporation": true, "issuer_corporation_id": 456, "issuer_id": 123, "price": 1000000.01, "reward": 0.01, "start_location_id": 60014719, "status": "outstanding", "type": "auction", "volume": 0.01 } ]

Request

Path Params

character_id

integer

required

An EVE character ID

Query Params

datasource

string

optional

The server name you would like data from

page

integer

optional

Which page of results to return

token

string

optional

Access token to use if unable to set a header

Header Params

If-None-Match

string

optional

ETag from a previous request. A 304 will be returned if this matches the current ETag

Responses

🟢200A list of contracts

application/json

Body

200 ok array

array of:

acceptor_id

integer <int32>

get_characters_character_id_contracts_acceptor_id

required

Who will accept the contract

assignee_id

integer <int32>

get_characters_character_id_contracts_assignee_id

required

ID to whom the contract is assigned, can be corporation or character ID

availability

enum<string>

get_characters_character_id_contracts_availability

required

To whom the contract is available

Allowed values:

publicpersonalcorporationalliance

buyout

number <double>

get_characters_character_id_contracts_buyout

optional

Buyout price (for Auctions only)

collateral

number <double>

get_characters_character_id_contracts_collateral

optional

Collateral price (for Couriers only)

contract_id

integer <int32>

get_characters_character_id_contracts_contract_id

required

contract_id integer

date_accepted

string <date-time>

get_characters_character_id_contracts_date_accepted

optional

Date of confirmation of contract

date_completed

string <date-time>

get_characters_character_id_contracts_date_completed

optional

Date of completed of contract

date_expired

string <date-time>

get_characters_character_id_contracts_date_expired

required

Expiration date of the contract

date_issued

string <date-time>

get_characters_character_id_contracts_date_issued

required

Сreation date of the contract

days_to_complete

integer <int32>

get_characters_character_id_contracts_days_to_complete

optional

Number of days to perform the contract

end_location_id

integer <int64>

get_characters_character_id_contracts_end_location_id

optional

End location ID (for Couriers contract)

for_corporation

boolean

get_characters_character_id_contracts_for_corporation

required

true if the contract was issued on behalf of the issuer's corporation

issuer_corporation_id

integer <int32>

get_characters_character_id_contracts_issuer_corporation_id

required

Character's corporation ID for the issuer

issuer_id

integer <int32>

get_characters_character_id_contracts_issuer_id

required

Character ID for the issuer

price

number <double>

get_characters_character_id_contracts_price

optional

Price of contract (for ItemsExchange and Auctions)

reward

number <double>

get_characters_character_id_contracts_reward

optional

Remuneration for contract (for Couriers only)

start_location_id

integer <int64>

get_characters_character_id_contracts_start_location_id

optional

Start location ID (for Couriers contract)

status

enum<string>

get_characters_character_id_contracts_status

required

Status of the the contract

Allowed values:

outstandingin_progressfinished_issuerfinished_contractorfinishedcancelledrejectedfaileddeletedreversed

title

string

get_characters_character_id_contracts_title

optional

Title of the contract

type

enum<string>

get_characters_character_id_contracts_type

required

Type of the contract

Allowed values:

unknownitem_exchangeauctioncourierloan

volume

number <double>

get_characters_character_id_contracts_volume

optional

Volume of items in the contract

🔵304Not modified

🟠400Bad request

🟠401Unauthorized

🟠403Forbidden

🟠420Error limited

🔴500Internal server error

🔴503Service unavailable

🔴504Gateway timeout