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