EVE Online

EVE Online Location API

The Location API from EVE Online — 6 operation(s) for location.

Documentation GitHub OpenAPI

Operations 6

GET /characters/{character_id}/location/ EVE Online Get Character Location #

GET /characters/{character_id}/online/ EVE Online Get Character Online #

GET /characters/{character_id}/ship/ EVE Online Get Current Ship #

GET /v1/characters/{character_id}/location/ Get character location #

GET /v1/characters/{character_id}/ship/ Get current ship #

GET /v2/characters/{character_id}/online/ Get character online #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/eve-online-location-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Eve Online Location API
  version: '1.36'
  description: 'Operations tagged Location across 7 of this provider''s published API definitions: eve-online-openapi.yml, swagger.json, swagger_2.json, swagger_3.json, swagger_4.json, swagger_5.json, swagger_6.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://esi.evetech.net/latest
- url: https://esi.evetech.net
- url: https://esi.evetech.net/legacy
- url: https://esi.evetech.net/dev
tags:
- name: Location
paths:
  /characters/{character_id}/location/:
    get:
      description: 'Information about the characters current location. Returns the current solar system id, and also the current station or structure ID if applicable


        ---

        Alternate route: `/dev/characters/{character_id}/location/`


        Alternate route: `/legacy/characters/{character_id}/location/`


        Alternate route: `/v1/characters/{character_id}/location/`


        Alternate route: `/v2/characters/{character_id}/location/`


        ---

        This route is cached for up to 5 seconds'
      operationId: get_characters_character_id_location
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Information about the characters current location. Returns the current solar system id, and also the current station or structure ID if applicable
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  solar_system_id:
                    description: solar_system_id integer
                    format: int32
                    title: get_characters_character_id_location_solar_system_id
                    type: integer
                  station_id:
                    description: station_id integer
                    format: int32
                    title: get_characters_character_id_location_station_id
                    type: integer
                  structure_id:
                    description: structure_id integer
                    format: int64
                    title: get_characters_character_id_location_structure_id
                    type: integer
                required:
                - solar_system_id
                title: get_characters_character_id_location_ok
                type: object
              examples:
                response:
                  value:
                    solar_system_id: 30002505
                    structure_id: 1000000016989
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized'
              examples:
                response:
                  value:
                    error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden'
              examples:
                response:
                  value:
                    error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      security:
      - evesso:
        - esi-location.read_location.v1
      summary: EVE Online Get Character Location
      tags:
      - Location
      x-alternate-versions:
      - dev
      - legacy
      - v1
      - v2
      x-cached-seconds: 5
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /characters/{character_id}/online/:
    get:
      description: 'Checks if the character is currently online


        ---

        Alternate route: `/dev/characters/{character_id}/online/`


        Alternate route: `/v2/characters/{character_id}/online/`


        Alternate route: `/v3/characters/{character_id}/online/`


        ---

        This route is cached for up to 60 seconds'
      operationId: get_characters_character_id_online
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Object describing the character's online status
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  last_login:
                    description: Timestamp of the last login
                    format: date-time
                    title: get_characters_character_id_online_last_login
                    type: string
                  last_logout:
                    description: Timestamp of the last logout
                    format: date-time
                    title: get_characters_character_id_online_last_logout
                    type: string
                  logins:
                    description: Total number of times the character has logged in
                    format: int32
                    title: get_characters_character_id_online_logins
                    type: integer
                  online:
                    description: If the character is online
                    title: get_characters_character_id_online_online
                    type: boolean
                required:
                - online
                title: get_characters_character_id_online_ok
                type: object
              examples:
                response:
                  value:
                    last_login: 2017-01-02 03:04:05+00:00
                    last_logout: 2017-01-02 04:05:06+00:00
                    logins: 9001
                    online: true
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized'
              examples:
                response:
                  value:
                    error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden'
              examples:
                response:
                  value:
                    error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      security:
      - evesso:
        - esi-location.read_online.v1
      summary: EVE Online Get Character Online
      tags:
      - Location
      x-alternate-versions:
      - dev
      - v2
      - v3
      x-cached-seconds: 60
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /characters/{character_id}/ship/:
    get:
      description: 'Get the current ship type, name and id


        ---

        Alternate route: `/dev/characters/{character_id}/ship/`


        Alternate route: `/legacy/characters/{character_id}/ship/`


        Alternate route: `/v1/characters/{character_id}/ship/`


        Alternate route: `/v2/characters/{character_id}/ship/`


        ---

        This route is cached for up to 5 seconds'
      operationId: get_characters_character_id_ship
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Get the current ship type, name and id
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  ship_item_id:
                    description: Item id's are unique to a ship and persist until it is repackaged. This value can be used to track repeated uses of a ship, or detect when a pilot changes into a different instance of the same ship type.
                    format: int64
                    title: get_characters_character_id_ship_ship_item_id
                    type: integer
                  ship_name:
                    description: ship_name string
                    title: get_characters_character_id_ship_ship_name
                    type: string
                  ship_type_id:
                    description: ship_type_id integer
                    format: int32
                    title: get_characters_character_id_ship_ship_type_id
                    type: integer
                required:
                - ship_type_id
                - ship_item_id
                - ship_name
                title: get_characters_character_id_ship_ok
                type: object
              examples:
                response:
                  value:
                    ship_item_id: 1000000016991
                    ship_name: SPACESHIPS!!!
                    ship_type_id: 1233
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request'
              examples:
                response:
                  value:
                    error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized'
              examples:
                response:
                  value:
                    error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden'
              examples:
                response:
                  value:
                    error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited'
              examples:
                response:
                  value:
                    error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error'
              examples:
                response:
                  value:
                    error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable'
              examples:
                response:
                  value:
                    error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout'
              examples:
                response:
                  value:
                    error: Gateway timeout message
      security:
      - evesso:
        - esi-location.read_ship_type.v1
      summary: EVE Online Get Current Ship
      tags:
      - Location
      x-alternate-versions:
      - dev
      - legacy
      - v1
      - v2
      x-cached-seconds: 5
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /v1/characters/{character_id}/location/:
    get:
      description: 'Information about the characters current location. Returns the current solar system id, and also the current station or structure ID if applicable


        ---


        This route is cached for up to 5 seconds'
      operationId: get_characters_character_id_location
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Information about the characters current location. Returns the current solar system id, and also the current station or structure ID if applicable
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  solar_system_id:
                    description: solar_system_id integer
                    format: int32
                    title: get_characters_character_id_location_solar_system_id
                    type: integer
                  station_id:
                    description: station_id integer
                    format: int32
                    title: get_characters_character_id_location_station_id
                    type: integer
                  structure_id:
                    description: structure_id integer
                    format: int64
                    title: get_characters_character_id_location_structure_id
                    type: integer
                required:
                - solar_system_id
                title: get_characters_character_id_location_ok
                type: object
              example:
                solar_system_id: 30002505
                structure_id: 1000000016989
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_2'
              example:
                error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized_2'
              example:
                error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden_2'
              example:
                error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited_2'
              example:
                error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error_2'
              example:
                error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable_2'
              example:
                error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout_2'
              example:
                error: Gateway timeout message
      security:
      - evesso:
        - esi-location.read_location.v1
      summary: Get character location
      tags:
      - Location
      x-alternate-versions:
      - latest
      - legacy
      - v1
      - v2
      x-cached-seconds: 5
    servers:
    - url: https://esi.evetech.net
  /v1/characters/{character_id}/ship/:
    get:
      description: 'Get the current ship type, name and id


        ---


        This route is cached for up to 5 seconds'
      operationId: get_characters_character_id_ship
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Get the current ship type, name and id
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  ship_item_id:
                    description: Item id's are unique to a ship and persist until it is repackaged. This value can be used to track repeated uses of a ship, or detect when a pilot changes into a different instance of the same ship type.
                    format: int64
                    title: get_characters_character_id_ship_ship_item_id
                    type: integer
                  ship_name:
                    description: ship_name string
                    title: get_characters_character_id_ship_ship_name
                    type: string
                  ship_type_id:
                    description: ship_type_id integer
                    format: int32
                    title: get_characters_character_id_ship_ship_type_id
                    type: integer
                required:
                - ship_type_id
                - ship_item_id
                - ship_name
                title: get_characters_character_id_ship_ok
                type: object
              example:
                ship_item_id: 1000000016991
                ship_name: SPACESHIPS!!!
                ship_type_id: 1233
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_2'
              example:
                error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized_2'
              example:
                error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden_2'
              example:
                error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited_2'
              example:
                error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error_2'
              example:
                error: Internal server error message
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/service_unavailable_2'
              example:
                error: Service unavailable message
        '504':
          description: Gateway timeout
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/gateway_timeout_2'
              example:
                error: Gateway timeout message
      security:
      - evesso:
        - esi-location.read_ship_type.v1
      summary: Get current ship
      tags:
      - Location
      x-alternate-versions:
      - latest
      - legacy
      - v1
      - v2
      x-cached-seconds: 5
    servers:
    - url: https://esi.evetech.net
  /v2/characters/{character_id}/online/:
    get:
      description: 'Checks if the character is currently online


        ---


        This route is cached for up to 60 seconds'
      operationId: get_characters_character_id_online
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: Object describing the character's online status
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
          content:
            application/json:
              schema:
                description: 200 ok object
                properties:
                  last_login:
                    description: Timestamp of the last login
                    format: date-time
                    title: get_characters_character_id_online_last_login
                    type: string
                  last_logout:
                    description: Timestamp of the last logout
                    format: date-time
                    title: get_characters_character_id_online_last_logout
                    type: string
                  logins:
                    description: Total number of times the character has logged in
                    format: int32
                    title: get_characters_character_id_online_logins
                    type: integer
                  online:
                    description: If the character is online
                    title: get_characters_character_id_online_online
                    type: boolean
                required:
                - online
                title: get_characters_character_id_online_ok
                type: object
              example:
                last_login: '2017-01-02T03:04:05Z'
                last_logout: '2017-01-02T04:05:06Z'
                logins: 9001
                online: true
        '304':
          description: Not modified
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            ETag:
              description: RFC7232 compliant entity tag
              schema:
                type: string
            Expires:
              description: RFC7231 formatted datetime string
              schema:
                type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              schema:
                type: string
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_2'
              example:
                error: Bad request message
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unauthorized_2'
              example:
                error: Unauthorized message
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/forbidden_2'
              example:
                error: Forbidden message
        '420':
          description: Error limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_limited_2'
              example:
                error: Error limited message
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/internal_server_error_2'
              example:
                error: Internal server error message
        '503':
      

# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-location-api-openapi.yml