EVE Online
EVE Online Universe API

The Universe API from EVE Online — 79 operation(s) for universe.
Documentation GitHub OpenAPI
OpenAPI Specification

openapi: 3.0.0
info:
  description: An OpenAPI for EVE Online
  title: EVE Swagger Interface Alliance Universe API
  version: '1.36'
servers:
- url: https://esi.evetech.net/latest
tags:
- name: Universe
paths:
  /universe/ancestries/:
    get:
      description: 'Get all character ancestries


        ---

        Alternate route: `/legacy/universe/ancestries/`


        Alternate route: `/v1/universe/ancestries/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_ancestries
      parameters:
      - $ref: '#/components/parameters/Accept-Language'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/language'
      responses:
        '200':
          description: A list of ancestries
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            Content-Language:
              description: The language used in the response
              schema:
                type: string
                enum:
                - en
                - de
                - fr
                - ja
                - ru
                - zh
                - ko
                - es
            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 array
                items:
                  description: 200 ok object
                  properties:
                    bloodline_id:
                      description: The bloodline associated with this ancestry
                      format: int32
                      title: get_universe_ancestries_bloodline_id
                      type: integer
                    description:
                      description: description string
                      title: get_universe_ancestries_description
                      type: string
                    icon_id:
                      description: icon_id integer
                      format: int32
                      title: get_universe_ancestries_icon_id
                      type: integer
                    id:
                      description: id integer
                      format: int32
                      title: get_universe_ancestries_id
                      type: integer
                    name:
                      description: name string
                      title: get_universe_ancestries_name
                      type: string
                    short_description:
                      description: short_description string
                      title: get_universe_ancestries_short_description
                      type: string
                  required:
                  - id
                  - name
                  - bloodline_id
                  - description
                  title: get_universe_ancestries_200_ok
                  type: object
                maxItems: 100
                title: get_universe_ancestries_ok
                type: array
              examples:
                response:
                  value:
                  - bloodline_id: 1
                    description: Acutely aware of the small population...
                    id: 12
                    name: Tube Child
                    short_description: Manufactured citizens of the State.
        '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
        '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
      summary: EVE Online Get Ancestries
      tags:
      - Universe
      x-alternate-versions:
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /universe/asteroid_belts/{asteroid_belt_id}/:
    get:
      description: 'Get information on an asteroid belt


        ---

        Alternate route: `/legacy/universe/asteroid_belts/{asteroid_belt_id}/`


        Alternate route: `/v1/universe/asteroid_belts/{asteroid_belt_id}/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_asteroid_belts_asteroid_belt_id
      parameters:
      - description: asteroid_belt_id integer
        in: path
        name: asteroid_belt_id
        required: true
        schema:
          type: integer
          format: int32
        example: 1001
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: Information about an asteroid belt
          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:
                  name:
                    description: name string
                    title: get_universe_asteroid_belts_asteroid_belt_id_name
                    type: string
                  position:
                    description: position object
                    properties:
                      x:
                        description: x number
                        format: double
                        title: get_universe_asteroid_belts_asteroid_belt_id_x
                        type: number
                      y:
                        description: y number
                        format: double
                        title: get_universe_asteroid_belts_asteroid_belt_id_y
                        type: number
                      z:
                        description: z number
                        format: double
                        title: get_universe_asteroid_belts_asteroid_belt_id_z
                        type: number
                    required:
                    - x
                    - y
                    - z
                    title: get_universe_asteroid_belts_asteroid_belt_id_position
                    type: object
                  system_id:
                    description: The solar system this asteroid belt is in
                    format: int32
                    title: get_universe_asteroid_belts_asteroid_belt_id_system_id
                    type: integer
                required:
                - name
                - position
                - system_id
                title: get_universe_asteroid_belts_asteroid_belt_id_ok
                type: object
              examples:
                response:
                  value:
                    name: Tanoo I - Asteroid Belt 1
                    position:
                      x: 161967513600
                      y: 21288837120
                      z: -73505464320
                    system_id: 30000001
        '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
        '404':
          description: Asteroid belt not found
          content:
            application/json:
              schema:
                description: Not found
                properties:
                  error:
                    description: Not found message
                    title: get_universe_asteroid_belts_asteroid_belt_id_404_not_found
                    type: string
                title: get_universe_asteroid_belts_asteroid_belt_id_not_found
                type: object
              examples:
                response:
                  value:
                    error: Not found 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
      summary: EVE Online Get Asteroid Belt Information
      tags:
      - Universe
      x-alternate-versions:
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /universe/bloodlines/:
    get:
      description: 'Get a list of bloodlines


        ---

        Alternate route: `/legacy/universe/bloodlines/`


        Alternate route: `/v1/universe/bloodlines/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_bloodlines
      parameters:
      - $ref: '#/components/parameters/Accept-Language'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/language'
      responses:
        '200':
          description: A list of bloodlines
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            Content-Language:
              description: The language used in the response
              schema:
                type: string
                enum:
                - en
                - de
                - fr
                - ja
                - ru
                - zh
                - ko
                - es
            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 array
                items:
                  description: 200 ok object
                  properties:
                    bloodline_id:
                      description: bloodline_id integer
                      format: int32
                      title: get_universe_bloodlines_bloodline_id
                      type: integer
                    charisma:
                      description: charisma integer
                      format: int32
                      title: get_universe_bloodlines_charisma
                      type: integer
                    corporation_id:
                      description: corporation_id integer
                      format: int32
                      title: get_universe_bloodlines_corporation_id
                      type: integer
                    description:
                      description: description string
                      title: get_universe_bloodlines_description
                      type: string
                    intelligence:
                      description: intelligence integer
                      format: int32
                      title: get_universe_bloodlines_intelligence
                      type: integer
                    memory:
                      description: memory integer
                      format: int32
                      title: get_universe_bloodlines_memory
                      type: integer
                    name:
                      description: name string
                      title: get_universe_bloodlines_name
                      type: string
                    perception:
                      description: perception integer
                      format: int32
                      title: get_universe_bloodlines_perception
                      type: integer
                    race_id:
                      description: race_id integer
                      format: int32
                      title: get_universe_bloodlines_race_id
                      type: integer
                    ship_type_id:
                      description: ship_type_id integer
                      format: int32
                      title: get_universe_bloodlines_ship_type_id
                      type: integer
                      nullable: true
                    willpower:
                      description: willpower integer
                      format: int32
                      title: get_universe_bloodlines_willpower
                      type: integer
                  required:
                  - bloodline_id
                  - name
                  - description
                  - race_id
                  - ship_type_id
                  - corporation_id
                  - perception
                  - willpower
                  - charisma
                  - memory
                  - intelligence
                  title: get_universe_bloodlines_200_ok
                  type: object
                maxItems: 100
                title: get_universe_bloodlines_ok
                type: array
              examples:
                response:
                  value:
                  - bloodline_id: 1
                    charisma: 6
                    corporation_id: 1000006
                    description: The Deteis are regarded as ...
                    intelligence: 7
                    memory: 7
                    name: Deteis
                    perception: 5
                    race_id: 1
                    ship_type_id: 601
                    willpower: 5
        '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
        '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
      summary: EVE Online Get Bloodlines
      tags:
      - Universe
      x-alternate-versions:
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /universe/categories/:
    get:
      description: 'Get a list of item categories


        ---

        Alternate route: `/legacy/universe/categories/`


        Alternate route: `/v1/universe/categories/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_categories
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: A list of item category ids
          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 array
                items:
                  description: 200 ok integer
                  format: int32
                  title: get_universe_categories_200_ok
                  type: integer
                maxItems: 10000
                title: get_universe_categories_ok
                type: array
              examples:
                response:
                  value:
                  - 1
                  - 2
                  - 3
        '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
        '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
      summary: EVE Online Get Item Categories
      tags:
      - Universe
      x-alternate-versions:
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /universe/categories/{category_id}/:
    get:
      description: 'Get information of an item category


        ---

        Alternate route: `/legacy/universe/categories/{category_id}/`


        Alternate route: `/v1/universe/categories/{category_id}/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_categories_category_id
      parameters:
      - $ref: '#/components/parameters/Accept-Language'
      - description: An Eve item category ID
        in: path
        name: category_id
        required: true
        schema:
          type: integer
          format: int32
        example: 1001
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/language'
      responses:
        '200':
          description: Information about an item category
          headers:
            Cache-Control:
              description: The caching mechanism used
              schema:
                type: string
            Content-Language:
              description: The language used in the response
              schema:
                type: string
                enum:
                - en
                - de
                - fr
                - ja
                - ru
                - zh
                - ko
                - es
            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:
                  category_id:
                    description: category_id integer
                    format: int32
                    title: get_universe_categories_category_id_category_id
                    type: integer
                  groups:
                    description: groups array
                    items:
                      description: group integer
                      format: int32
                      title: get_universe_categories_category_id_group
                      type: integer
                    maxItems: 10000
                    title: get_universe_categories_category_id_groups
                    type: array
                  name:
                    description: name string
                    title: get_universe_categories_category_id_name
                    type: string
                  published:
                    description: published boolean
                    title: get_universe_categories_category_id_published
                    type: boolean
                required:
                - category_id
                - name
                - published
                - groups
                title: get_universe_categories_category_id_ok
                type: object
              examples:
                response:
                  value:
                    category_id: 6
                    groups:
                    - 25
                    - 26
                    - 27
                    name: Ship
                    published: 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
        '404':
          description: Category not found
          content:
            application/json:
              schema:
                description: Not found
                properties:
                  error:
                    description: Not found message
                    title: get_universe_categories_category_id_404_not_found
                    type: string
                title: get_universe_categories_category_id_not_found
                type: object
              examples:
                response:
                  value:
                    error: Not found 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
      summary: EVE Online Get Item Category Information
      tags:
      - Universe
      x-alternate-versions:
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /universe/constellations/:
    get:
      description: 'Get a list of constellations


        ---

        Alternate route: `/legacy/universe/constellations/`


        Alternate route: `/v1/universe/constellations/`


        ---

        This route expires daily at 11:05'
      operationId: get_universe_constellations
      parameters:
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: A list of constellation ids
          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 array
                items:
                  description: 200 ok integer
                  format: int32
                  title: get_universe_constellations_200_ok
                  type: integer
                maxItems: 10000
                title: get_universe_constellations_ok
                type: array
              examples:
                response:
                  value:
                  - 20000001
                  - 20000002
        '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
        '4

# --- truncated at 32 KB (441 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-universe-api-openapi.yml
EVE Online Universe API

Documentation

Specifications

Other Resources

OpenAPI Specification
