EVE Swagger Interface
  1. Contracts
EVE Swagger Interface
  • Alliance
    • List all alliances
      GET
    • Get alliance information
      GET
    • List alliance's corporations
      GET
    • Get alliance icon
      GET
  • Contacts
    • Get alliance contacts
      GET
    • Get alliance contact labels
      GET
    • Delete contacts
      DELETE
    • Get contacts
      GET
    • Add contacts
      POST
    • Edit contacts
      PUT
    • Get contact labels
      GET
    • Get corporation contacts
      GET
    • Get corporation contact labels
      GET
  • Character
    • Character affiliation
      POST
    • Get character's public information
      GET
    • Get agents research
      GET
    • Get blueprints
      GET
    • Get corporation history
      GET
    • Calculate a CSPA charge cost
      POST
    • Get jump fatigue
      GET
    • Get medals
      GET
    • Get character notifications
      GET
    • Get new contact notifications
      GET
    • Get character portraits
      GET
    • Get character corporation roles
      GET
    • Get standings
      GET
    • Yearly aggregate stats
      GET
    • Get character corporation titles
      GET
  • Assets
    • Get character assets
    • Get character asset locations
    • Get character asset names
    • Get corporation assets
    • Get corporation asset locations
    • Get corporation asset names
  • Skills
    • Get character attributes
    • Get character's skill queue
    • Get character skills
  • Bookmarks
    • List bookmarks
    • List bookmark folders
    • List corporation bookmarks
    • List corporation bookmark folders
  • Calendar
    • List calendar event summaries
    • Get an event
    • Respond to an event
    • Get attendees
  • Clones
    • Get clones
    • Get active implants
  • Contracts
    • Get contracts
      GET
    • Get contract bids
      GET
    • Get contract items
      GET
    • Get public contract bids
      GET
    • Get public contract items
      GET
    • Get public contracts
      GET
    • Get corporation contracts
      GET
    • Get corporation contract bids
      GET
    • Get corporation contract items
      GET
  • Fittings
    • Get fittings
    • Create fitting
    • Delete fitting
  • Fleets
    • Get character fleet info
    • Get fleet information
    • Update fleet
    • Get fleet members
    • Create fleet invitation
    • Kick fleet member
    • Move fleet member
    • Delete fleet squad
    • Rename fleet squad
    • Get fleet wings
    • Create fleet wing
    • Delete fleet wing
    • Rename fleet wing
    • Create fleet squad
  • Faction Warfare
    • Overview of a character involved in faction warfare
    • Overview of a corporation involved in faction warfare
    • List of the top factions in faction warfare
    • List of the top pilots in faction warfare
    • List of the top corporations in faction warfare
    • An overview of statistics about factions involved in faction warfare
    • Ownership of faction warfare systems
    • Data about which NPC factions are at war
  • Industry
    • List character industry jobs
    • Character mining ledger
    • Moon extraction timers
    • Corporation mining observers
    • Observed corporation mining
    • List corporation industry jobs
    • List industry facilities
    • List solar system cost indices
  • Killmails
    • Get a character's recent kills and losses
    • Get a corporation's recent kills and losses
    • Get a single killmail
  • Location
    • Get character location
    • Get character online
    • Get current ship
  • Loyalty
    • Get loyalty points
    • List loyalty store offers
  • Mail
    • Return mail headers
    • Send a new mail
    • Get mail labels and unread counts
    • Create a mail label
    • Delete a mail label
    • Return mailing list subscriptions
    • Delete a mail
    • Return a mail
    • Update metadata about a mail
  • Opportunities
    • Get a character's completed tasks
    • Get opportunities groups
    • Get opportunities group
    • Get opportunities tasks
    • Get opportunities task
  • Market
    • List open orders from a character
    • List historical orders by a character
    • List open orders from a corporation
    • List historical orders from a corporation
    • Get item groups
    • Get item group information
    • List market prices
    • List orders in a structure
    • List historical market statistics in a region
    • List orders in a region
    • List type IDs relevant to a market
  • Planetary Interaction
    • Get colonies
    • Get colony layout
    • List corporation customs offices
    • Get schematic information
  • Search
    • Search on a string
    • Search on a string
  • Wallet
    • Get a character's wallet balance
    • Get character wallet journal
    • Get wallet transactions
    • Returns a corporation's wallet balance
    • Get corporation wallet journal
    • Get corporation wallet transactions
  • Corporation
    • Get npc corporations
    • Get corporation information
    • Get alliance history
    • Get corporation blueprints
    • Get all corporation ALSC logs
    • Get corporation divisions
    • Get corporation facilities
    • Get corporation icon
    • Get corporation medals
    • Get corporation issued medals
    • Get corporation members
    • Get corporation member limit
    • Get corporation's members' titles
    • Track corporation members
    • Get corporation member roles
    • Get corporation member roles history
    • Get corporation shareholders
    • Get corporation standings
    • Get corporation starbases (POSes)
    • Get starbase (POS) detail
    • Get corporation structures
    • Get corporation titles
  • Dogma
    • Get attributes
    • Get attribute information
    • Get dynamic item information
    • Get effects
    • Get effect information
  • Incursions
    • List incursions
  • Insurance
    • List insurance levels
  • Routes
    • Get route
  • Sovereignty
    • List sovereignty campaigns
    • List sovereignty of systems
    • List sovereignty structures
  • Status
    • Retrieve the uptime and player counts
  • User Interface
    • Set Autopilot Waypoint
    • Open Contract Window
    • Open Information Window
    • Open Market Details
    • Open New Mail Window
  • Universe
    • Get ancestries
    • Get asteroid belt information
    • Get bloodlines
    • Get item categories
    • Get item category information
    • Get constellations
    • Get constellation information
    • Get factions
    • Get graphics
    • Get graphic information
    • Get item groups
    • Get item group information
    • Bulk names to IDs
    • Get moon information
    • Get names and categories for a set of ID's
    • Get planet information
    • Get character races
    • Get regions
    • Get region information
    • Get stargate information
    • Get star information
    • Get station information
    • List all public structures
    • Get structure information
    • Get system jumps
    • Get system kills
    • Get solar systems
    • Get solar system information
    • Get types
    • Get type information
  • Wars
    • List wars
    • Get war information
    • List kills for a war
  1. Contracts

Get public contracts

GET
/contracts/public/{region_id}/
Contracts
Returns a paginated list of all public contracts in the given region
Alternate route: /dev/contracts/public/{region_id}/
Alternate route: /legacy/contracts/public/{region_id}/
Alternate route: /v1/contracts/public/{region_id}/
This route is cached for up to 1800 seconds
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://esi.evetech.net/latest/contracts/public//'
Response Response Example
200 - response
[
  {
    "buyout": 10000000000.01,
    "contract_id": 1,
    "date_expired": "2023-08-15T09:13:17.867Z",
    "date_issued": "2023-08-15T09:13:17.867Z",
    "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,
    "type": "auction",
    "volume": 0.01
  }
]

Request

Path Params
region_id
integer 
required
An EVE region id
Query Params
datasource
string 
optional
The server name you would like data from
page
integer 
optional
Which page of results to return
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:
buyout
number <double>
get_contracts_public_region_id_buyout
optional
Buyout price (for Auctions only)
collateral
number <double>
get_contracts_public_region_id_collateral
optional
Collateral price (for Couriers only)
contract_id
integer <int32>
get_contracts_public_region_id_contract_id
required
contract_id integer
date_expired
string <date-time>
get_contracts_public_region_id_date_expired
required
Expiration date of the contract
date_issued
string <date-time>
get_contracts_public_region_id_date_issued
required
Сreation date of the contract
days_to_complete
integer <int32>
get_contracts_public_region_id_days_to_complete
optional
Number of days to perform the contract
end_location_id
integer <int64>
get_contracts_public_region_id_end_location_id
optional
End location ID (for Couriers contract)
for_corporation
boolean 
get_contracts_public_region_id_for_corporation
optional
true if the contract was issued on behalf of the issuer's corporation
issuer_corporation_id
integer <int32>
get_contracts_public_region_id_issuer_corporation_id
required
Character's corporation ID for the issuer
issuer_id
integer <int32>
get_contracts_public_region_id_issuer_id
required
Character ID for the issuer
price
number <double>
get_contracts_public_region_id_price
optional
Price of contract (for ItemsExchange and Auctions)
reward
number <double>
get_contracts_public_region_id_reward
optional
Remuneration for contract (for Couriers only)
start_location_id
integer <int64>
get_contracts_public_region_id_start_location_id
optional
Start location ID (for Couriers contract)
title
string 
get_contracts_public_region_id_title
optional
Title of the contract
type
enum<string> 
get_contracts_public_region_id_type
required
Type of the contract
Allowed values:
unknownitem_exchangeauctioncourierloan
volume
number <double>
get_contracts_public_region_id_volume
optional
Volume of items in the contract
🔵304Not modified
🟠400Bad request
🟠404Region not found
🟠420Error limited
🔴500Internal server error
🔴503Service unavailable
🔴504Gateway timeout
Modified at 2023-08-15 09:13:24
Previous
Get public contract items
Next
Get corporation contracts
Built with