CCP Games Assets API
The Assets API from CCP Games — 6 operation(s) for assets.
The Assets API from CCP Games — 6 operation(s) for assets.
openapi: 3.1.0
info:
contact:
name: ESI Support
url: https://developers.eveonline.com/docs/support/
license:
name: EVE Developer License
url: https://developers.eveonline.com/license-agreement
termsOfService: https://support.eveonline.com/hc/en-us/articles/8414770561948-EVE-Online-Terms-of-Service
title: EVE Swagger Incineration (ESI) - tranquility Alliance Assets API
version: '2020-01-01'
servers:
- url: https://esi.evetech.net
tags:
- name: Assets
paths:
/characters/{character_id}/assets:
get:
description: Return a list of the characters assets
operationId: GetCharactersCharacterIdAssets
parameters:
- description: The ID of the character
in: path
name: character_id
required: true
schema:
$ref: '#/components/schemas/CharacterID'
- in: query
name: page
schema:
description: Which page of results to return.
format: int32
minimum: 1
type: integer
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CharactersCharacterIdAssetsGet'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
X-Pages:
description: The total number of pages in the result set.
schema:
format: int64
type: integer
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_assets.v1
summary: Get character assets
tags:
- Assets
x-cache-age: 3600
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: char-asset
max-tokens: 1800
window-size: 15m
/characters/{character_id}/assets/locations:
post:
description: Return locations for a set of item ids, which you can get from character assets endpoint. Coordinates for items in hangars or stations are set to (0,0,0)
operationId: PostCharactersCharacterIdAssetsLocations
parameters:
- description: The ID of the character
in: path
name: character_id
required: true
schema:
$ref: '#/components/schemas/CharacterID'
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
requestBody:
content:
application/json:
schema:
items:
description: item_id integer
format: int64
type: integer
maxItems: 1000
minItems: 1
type: array
uniqueItems: true
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CharactersCharacterIdAssetsLocationsPost'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_assets.v1
summary: Get character asset locations
tags:
- Assets
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: char-asset
max-tokens: 1800
window-size: 15m
/characters/{character_id}/assets/names:
post:
description: Return names for a set of item ids, which you can get from character assets endpoint. Typically used for items that can customize names, like containers or ships.
operationId: PostCharactersCharacterIdAssetsNames
parameters:
- description: The ID of the character
in: path
name: character_id
required: true
schema:
$ref: '#/components/schemas/CharacterID'
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
requestBody:
content:
application/json:
schema:
items:
description: item_id integer
format: int64
type: integer
maxItems: 1000
minItems: 1
type: array
uniqueItems: true
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CharactersCharacterIdAssetsNamesPost'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_assets.v1
summary: Get character asset names
tags:
- Assets
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: char-asset
max-tokens: 1800
window-size: 15m
/corporations/{corporation_id}/assets:
get:
description: Return a list of the corporation assets
operationId: GetCorporationsCorporationIdAssets
parameters:
- description: The ID of the corporation
in: path
name: corporation_id
required: true
schema:
$ref: '#/components/schemas/CorporationID'
- in: query
name: page
schema:
description: Which page of results to return.
format: int32
minimum: 1
type: integer
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CorporationsCorporationIdAssetsGet'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
X-Pages:
description: The total number of pages in the result set.
schema:
format: int64
type: integer
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_corporation_assets.v1
summary: Get corporation assets
tags:
- Assets
x-cache-age: 3600
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: corp-asset
max-tokens: 1800
window-size: 15m
x-required-roles:
- Director
/corporations/{corporation_id}/assets/locations:
post:
description: Return locations for a set of item ids, which you can get from corporation assets endpoint. Coordinates for items in hangars or stations are set to (0,0,0)
operationId: PostCorporationsCorporationIdAssetsLocations
parameters:
- description: The ID of the corporation
in: path
name: corporation_id
required: true
schema:
$ref: '#/components/schemas/CorporationID'
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
requestBody:
content:
application/json:
schema:
items:
description: item_id integer
format: int64
type: integer
maxItems: 1000
minItems: 1
type: array
uniqueItems: true
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CorporationsCorporationIdAssetsLocationsPost'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_corporation_assets.v1
summary: Get corporation asset locations
tags:
- Assets
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: corp-asset
max-tokens: 1800
window-size: 15m
x-required-roles:
- Director
/corporations/{corporation_id}/assets/names:
post:
description: Return names for a set of item ids, which you can get from corporation assets endpoint. Only valid for items that can customize names, like containers or ships
operationId: PostCorporationsCorporationIdAssetsNames
parameters:
- description: The ID of the corporation
in: path
name: corporation_id
required: true
schema:
$ref: '#/components/schemas/CorporationID'
- $ref: '#/components/parameters/AcceptLanguage'
- $ref: '#/components/parameters/IfNoneMatch'
- $ref: '#/components/parameters/CompatibilityDate'
- $ref: '#/components/parameters/Tenant'
- $ref: '#/components/parameters/IfModifiedSince'
requestBody:
content:
application/json:
schema:
items:
description: item_id integer
format: int64
type: integer
maxItems: 1000
minItems: 1
type: array
uniqueItems: true
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CorporationsCorporationIdAssetsNamesPost'
description: OK
headers:
Cache-Control:
$ref: '#/components/headers/CacheControl'
ETag:
$ref: '#/components/headers/ETag'
Last-Modified:
$ref: '#/components/headers/LastModified'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
description: Error
security:
- OAuth2:
- esi-assets.read_corporation_assets.v1
summary: Get corporation asset names
tags:
- Assets
x-compatibility-date: '2020-01-01'
x-rate-limit:
group: corp-asset
max-tokens: 1800
window-size: 15m
x-required-roles:
- Director
components:
schemas:
CorporationsCorporationIdAssetsGet:
items:
properties:
is_blueprint_copy:
type: boolean
is_singleton:
type: boolean
item_id:
format: int64
type: integer
location_flag:
enum:
- AssetSafety
- AutoFit
- Bonus
- Booster
- BoosterBay
- Capsule
- CapsuleerDeliveries
- Cargo
- CorpDeliveries
- CorpSAG1
- CorpSAG2
- CorpSAG3
- CorpSAG4
- CorpSAG5
- CorpSAG6
- CorpSAG7
- CorporationGoalDeliveries
- CrateLoot
- Deliveries
- DroneBay
- DustBattle
- DustDatabank
- ExpeditionHold
- FighterBay
- FighterTube0
- FighterTube1
- FighterTube2
- FighterTube3
- FighterTube4
- FleetHangar
- FrigateEscapeBay
- Hangar
- HangarAll
- HiSlot0
- HiSlot1
- HiSlot2
- HiSlot3
- HiSlot4
- HiSlot5
- HiSlot6
- HiSlot7
- HiddenModifiers
- Implant
- Impounded
- InfrastructureHangar
- JunkyardReprocessed
- JunkyardTrashed
- LoSlot0
- LoSlot1
- LoSlot2
- LoSlot3
- LoSlot4
- LoSlot5
- LoSlot6
- LoSlot7
- Locked
- MedSlot0
- MedSlot1
- MedSlot2
- MedSlot3
- MedSlot4
- MedSlot5
- MedSlot6
- MedSlot7
- MobileDepotHold
- MoonMaterialBay
- OfficeFolder
- Pilot
- PlanetSurface
- QuafeBay
- QuantumCoreRoom
- Reward
- RigSlot0
- RigSlot1
- RigSlot2
- RigSlot3
- RigSlot4
- RigSlot5
- RigSlot6
- RigSlot7
- SecondaryStorage
- ServiceSlot0
- ServiceSlot1
- ServiceSlot2
- ServiceSlot3
- ServiceSlot4
- ServiceSlot5
- ServiceSlot6
- ServiceSlot7
- ShipHangar
- ShipOffline
- Skill
- SkillInTraining
- SpecializedAmmoHold
- SpecializedAsteroidHold
- SpecializedCommandCenterHold
- SpecializedFuelBay
- SpecializedGasHold
- SpecializedIceHold
- SpecializedIndustrialShipHold
- SpecializedLargeShipHold
- SpecializedMaterialBay
- SpecializedMediumShipHold
- SpecializedMineralHold
- SpecializedOreHold
- SpecializedPlanetaryCommoditiesHold
- SpecializedSalvageHold
- SpecializedShipHold
- SpecializedSmallShipHold
- StructureActive
- StructureFuel
- StructureInactive
- StructureOffline
- SubSystemBay
- SubSystemSlot0
- SubSystemSlot1
- SubSystemSlot2
- SubSystemSlot3
- SubSystemSlot4
- SubSystemSlot5
- SubSystemSlot6
- SubSystemSlot7
- Unlocked
- Wallet
- Wardrobe
type: string
location_id:
format: int64
type: integer
location_type:
enum:
- station
- solar_system
- item
- other
type: string
quantity:
format: int64
type: integer
type_id:
format: int64
type: integer
required:
- type_id
- quantity
- location_id
- location_type
- item_id
- location_flag
- is_singleton
type: object
type: array
CharactersCharacterIdAssetsLocationsPost:
items:
properties:
item_id:
format: int64
type: integer
position:
properties:
x:
format: double
type: number
y:
format: double
type: number
z:
format: double
type: number
required:
- x
- y
- z
type: object
required:
- item_id
- position
type: object
type: array
CorporationsCorporationIdAssetsLocationsPost:
items:
properties:
item_id:
format: int64
type: integer
position:
properties:
x:
format: double
type: number
y:
format: double
type: number
z:
format: double
type: number
required:
- x
- y
- z
type: object
required:
- item_id
- position
type: object
type: array
CharactersCharacterIdAssetsNamesPost:
items:
properties:
item_id:
format: int64
type: integer
name:
type: string
required:
- item_id
- name
type: object
type: array
CharactersCharacterIdAssetsGet:
items:
properties:
is_blueprint_copy:
type: boolean
is_singleton:
type: boolean
item_id:
format: int64
type: integer
location_flag:
enum:
- AssetSafety
- AutoFit
- BoosterBay
- CapsuleerDeliveries
- Cargo
- CorporationGoalDeliveries
- CorpseBay
- Deliveries
- DroneBay
- ExpeditionHold
- FighterBay
- FighterTube0
- FighterTube1
- FighterTube2
- FighterTube3
- FighterTube4
- FleetHangar
- FrigateEscapeBay
- Hangar
- HangarAll
- HiSlot0
- HiSlot1
- HiSlot2
- HiSlot3
- HiSlot4
- HiSlot5
- HiSlot6
- HiSlot7
- HiddenModifiers
- Implant
- InfrastructureHangar
- LoSlot0
- LoSlot1
- LoSlot2
- LoSlot3
- LoSlot4
- LoSlot5
- LoSlot6
- LoSlot7
- Locked
- MedSlot0
- MedSlot1
- MedSlot2
- MedSlot3
- MedSlot4
- MedSlot5
- MedSlot6
- MedSlot7
- MobileDepotHold
- MoonMaterialBay
- QuafeBay
- RigSlot0
- RigSlot1
- RigSlot2
- RigSlot3
- RigSlot4
- RigSlot5
- RigSlot6
- RigSlot7
- ShipHangar
- Skill
- SpecializedAmmoHold
- SpecializedAsteroidHold
- SpecializedCommandCenterHold
- SpecializedFuelBay
- SpecializedGasHold
- SpecializedIceHold
- SpecializedIndustrialShipHold
- SpecializedLargeShipHold
- SpecializedMaterialBay
- SpecializedMediumShipHold
- SpecializedMineralHold
- SpecializedOreHold
- SpecializedPlanetaryCommoditiesHold
- SpecializedSalvageHold
- SpecializedShipHold
- SpecializedSmallShipHold
- StructureDeedBay
- SubSystemBay
- SubSystemSlot0
- SubSystemSlot1
- SubSystemSlot2
- SubSystemSlot3
- SubSystemSlot4
- SubSystemSlot5
- SubSystemSlot6
- SubSystemSlot7
- Unlocked
- Wardrobe
type: string
location_id:
format: int64
type: integer
location_type:
enum:
- station
- solar_system
- item
- other
type: string
quantity:
format: int64
type: integer
type_id:
format: int64
type: integer
required:
- type_id
- quantity
- location_id
- location_type
- item_id
- location_flag
- is_singleton
type: object
type: array
CorporationID:
examples:
- 98777771
format: int64
type: integer
x-common-model: 'true'
Error:
properties:
details:
description: List of individual error details.
items:
$ref: '#/components/schemas/ErrorDetail'
type: array
error:
description: Error message.
type: string
required:
- error
type: object
ErrorDetail:
properties:
location:
description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
type: string
message:
description: Error message text
type: string
value:
description: The value at the given location
type: object
CorporationsCorporationIdAssetsNamesPost:
items:
properties:
item_id:
format: int64
type: integer
name:
type: string
required:
- item_id
- name
type: object
type: array
CharacterID:
examples:
- 90000001
format: int64
type: integer
x-common-model: 'true'
headers:
LastModified:
description: The last modified date of the response. Use this with If-Modified-Since to check whether the resource has changed.
schema:
type: string
ETag:
description: The ETag value of the response body. Use this with If-None-Match to check whether the resource has changed.
schema:
type: string
CacheControl:
description: Directives for caching mechanisms. It controls how the response can be cached, by whom, and for how long.
schema:
type: string
parameters:
AcceptLanguage:
description: The language to use for the response.
in: header
name: Accept-Language
schema:
default: en
enum:
- en
- de
- fr
- ja
- ru
- zh
- ko
- es
type: string
CompatibilityDate:
description: The compatibility date for the request.
in: header
name: X-Compatibility-Date
required: true
schema:
enum:
- '2020-01-01'
format: date
type: string
Tenant:
description: The tenant ID for the request.
example: ''
in: header
name: X-Tenant
schema:
default: tranquility
type: string
IfNoneMatch:
description: The ETag of the previous request. A 304 will be returned if this matches the current ETag.
in: header
name: If-None-Match
schema:
type: string
IfModifiedSince:
description: The date the resource was last modified. A 304 will be returned if the resource has not been modified since this date.
in: header
name: If-Modified-Since
schema:
type: string
securitySchemes:
OAuth2:
flows:
authorizationCode:
authorizationUrl: https://login.eveonline.com/v2/oauth/authorize
scopes:
esi-access.read_lists.v1: esi-access.read_lists.v1
esi-activities.read_character.v1: esi-activities.read_character.v1
esi-alliances.read_contacts.v1: esi-alliances.read_contacts.v1
esi-assets.read_assets.v1: esi-assets.read_assets.v1
esi-assets.read_corporation_assets.v1: esi-assets.read_corporation_assets.v1
esi-calendar.read_calendar_events.v1: esi-calendar.read_calendar_events.v1
esi-calendar.respond_calendar_events.v1: esi-calendar.respond_calendar_events.v1
esi-characters.read_agents_research.v1: esi-characters.read_agents_research.v1
esi-characters.read_blueprints.v1: esi-characters.read_blueprints.v1
esi-characters.read_contacts.v1: esi-characters.read_contacts.v1
esi-characters.read_corporation_roles.v1: esi-characters.read_corporation_roles.v1
esi-characters.read_fatigue.v1: esi-characters.read_fatigue.v1
esi-characters.read_freelance_jobs.v1: esi-characters.read_freelance_jobs.v1
esi-characters.read_fw_stats.v1: esi-characters.read_fw_stats.v1
esi-characters.read_loyalty.v1: esi-characters.read_loyalty.v1
esi-characters.read_medals.v1: esi-characters.read_medals.v1
esi-characters.read_notifications.v1: esi-characters.read_notifications.v1
esi-characters.read_standings.v1: esi-characters.read_standings.v1
esi-characters.read_titles.v1: esi-characters.read_titles.v1
esi-characters.write_contacts.v1: esi-characters.write_contacts.v1
esi-clones.read_clones.v1: esi-clones.read_clones.v1
esi-clones.read_implants.v1: esi-clones.read_implants.v1
esi-contracts.read_character_contracts.v1: esi-contracts.read_character_contracts.v1
esi-contracts.read_corporation_contracts.v1: esi-contracts.read_corporation_contracts.v1
esi-corporations.read_blueprints.v1: esi-corporations.read_blueprints.v1
esi-corporations.read_contacts.v1: esi-corporations.read_contacts.v1
esi-corporations.read_container_logs.v1: esi-corporations.read_container_logs.v1
esi-corporations.read_corporation_membership.v1: esi-corporations.read_corporation_membership.v1
esi-corporations.read_divisions.v1: esi-corporations.read_divisions.v1
esi-corporations.read_facilities.v1: esi-corporations.read_facilities.v1
esi-corporations.read_freelance_jobs.v1: esi-corporations.read_freelance_jobs.v1
esi-corporations.read_fw_stats.v1: esi-corporations.read_fw_stats.v1
esi-corporations.read_medals.v1: esi-corporations.read_medals.v1
esi-corporations.read_projects.v1: esi-corporations.read_projects.v1
esi-corporations.read_standings.v1: esi-corporations.read_standings.v1
esi-corporations.read_starbases.v1: esi-corporations.read_starbases.v1
esi-corporations.read_structures.v1: esi-corporations.read_structures.v1
esi-corporations.read_titles.v1: esi-corporations.read_titles.v1
esi-corporations.track_members.v1: esi-corporations.track_members.v1
esi-fittings.read_fittings.v1: esi-fittings.read_fittings.v1
esi-fittings.write_fittings.v1: esi-fittings.write_fittings.v1
esi-fleets.read_fleet.v1: esi-fleets.read_fleet.v1
esi-fleets.write_fleet.v1: esi-fleets.write_fleet.v1
esi-industry.read_character_jobs.v1: esi-industry.read_character_jobs.v1
esi-industry.read_character_mining.v1: esi-industry.read_character_mining.v1
esi-industry.read_corporation_jobs.v1: esi-industry.read_corporation_jobs.v1
esi-industry.read_corporation_mining.v1: esi-industry.read_corporation_mining.v1
esi-killmails.read_corporation_killmails.v1: esi-killmails.read_corporation_killmails.v1
esi-killmails.read_killmails.v1: esi-killmails.read_killmails.v1
esi-location.read_location.v1: esi-location.read_location.v1
esi-location.read_online.v1: esi-location.read_online.v1
esi-location.read_ship_type.v1: esi-location.read_ship_type.v1
esi-mail.organize_mail.v1: esi-mail.organize_mail.v1
esi-mail.read_mail.v1: esi-mail.read_mail.v1
esi-mail.send_mail.v1: esi-mail.send_mail.v1
esi-markets.read_character_orders.v1: esi-markets.read_character_orders.v1
esi-markets.read_corporation_orders.v1: esi-markets.read_corporation_orders.v1
esi-markets.structure_markets.v1: esi-markets.structure_markets.v1
esi-planets.manage_planets.v1: esi-planets.manage_planets.v1
esi-planets.read_customs_offices.v1: esi-planets.read_customs_offices.v1
esi-search.search_structures.v1: esi-search.search_structures.v1
esi-skills.read_skillqueue.v1: esi-skills.read_skillqueue.v1
esi-skills.read_skills.v1: esi-skills.read_skills.v1
esi-structures.read_character.v1: esi-structures.read_character.v1
esi-structures.read_corporation.v1: esi-structures.read_corporation.v1
esi-ui.open_window.v1: esi-ui.open_window.v1
esi-ui.write_waypoint.v1: esi-ui.write_waypoint.v1
esi-universe.read_structures.v1: esi-universe.read_structures.v1
esi-wallet.read_character_wallet.v1: esi-wallet.read_character_wallet.v1
esi-wallet.read_corporation_wallets.v1: esi-wallet.read_corporation_wallets.v1
tokenUrl: https://login.eveonline.com/v2/oauth/token
type: oauth2