EVE Online

EVE Online Fittings API

The Fittings API from EVE Online — 5 operation(s) for fittings.

GitHub OpenAPI

Documentation

📖
Documentation
https://developers.eveonline.com/docs/services/esi/
📖
BestPractices
https://developers.eveonline.com/docs/services/esi/best-practices/
📖
RateLimits
https://developers.eveonline.com/docs/services/esi/rate-limiting/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/openapi/eve-online-fittings-api-openapi.yml

Other Resources

🔗
APIExplorer
https://developers.eveonline.com/api-explorer
🔗
Swagger
https://esi.evetech.net/ui
🔗
GitHubRepo
https://github.com/esi/esi-docs
🔗
GitHubRepo
https://github.com/esi/esi-issues
🔗
GitHubRepo
https://github.com/esi/esi-routes
🔗
GitHubRepo
https://github.com/esi/eve-glue
🔗
SupportIssues
https://github.com/esi/esi-issues

OpenAPI Specification

eve-online-fittings-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  description: An OpenAPI for EVE Online
  title: EVE Swagger Interface Alliance Fittings API
  version: '1.36'
servers:
- url: https://esi.evetech.net/latest
tags:
- name: Fittings
paths:
  /characters/{character_id}/fittings/:
    get:
      description: 'Return fittings of a character


        ---

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


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


        ---

        This route is cached for up to 300 seconds'
      operationId: get_characters_character_id_fittings
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      - $ref: '#/components/parameters/token'
      responses:
        '200':
          description: A list of fittings
          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 object
                  properties:
                    description:
                      description: description string
                      title: get_characters_character_id_fittings_description
                      type: string
                    fitting_id:
                      description: fitting_id integer
                      format: int32
                      title: get_characters_character_id_fittings_fitting_id
                      type: integer
                    items:
                      description: items array
                      items:
                        description: item object
                        properties:
                          flag:
                            description: flag string
                            enum:
                            - Cargo
                            - DroneBay
                            - FighterBay
                            - HiSlot0
                            - HiSlot1
                            - HiSlot2
                            - HiSlot3
                            - HiSlot4
                            - HiSlot5
                            - HiSlot6
                            - HiSlot7
                            - Invalid
                            - LoSlot0
                            - LoSlot1
                            - LoSlot2
                            - LoSlot3
                            - LoSlot4
                            - LoSlot5
                            - LoSlot6
                            - LoSlot7
                            - MedSlot0
                            - MedSlot1
                            - MedSlot2
                            - MedSlot3
                            - MedSlot4
                            - MedSlot5
                            - MedSlot6
                            - MedSlot7
                            - RigSlot0
                            - RigSlot1
                            - RigSlot2
                            - ServiceSlot0
                            - ServiceSlot1
                            - ServiceSlot2
                            - ServiceSlot3
                            - ServiceSlot4
                            - ServiceSlot5
                            - ServiceSlot6
                            - ServiceSlot7
                            - SubSystemSlot0
                            - SubSystemSlot1
                            - SubSystemSlot2
                            - SubSystemSlot3
                            title: get_characters_character_id_fittings_flag
                            type: string
                          quantity:
                            description: quantity integer
                            format: int32
                            title: get_characters_character_id_fittings_quantity
                            type: integer
                          type_id:
                            description: type_id integer
                            format: int32
                            title: get_characters_character_id_fittings_type_id
                            type: integer
                        required:
                        - type_id
                        - flag
                        - quantity
                        title: get_characters_character_id_fittings_item
                        type: object
                      maxItems: 512
                      title: get_characters_character_id_fittings_items
                      type: array
                    name:
                      description: name string
                      title: get_characters_character_id_fittings_name
                      type: string
                    ship_type_id:
                      description: ship_type_id integer
                      format: int32
                      title: get_characters_character_id_fittings_ship_type_id
                      type: integer
                  required:
                  - fitting_id
                  - name
                  - description
                  - ship_type_id
                  - items
                  title: get_characters_character_id_fittings_200_ok
                  type: object
                maxItems: 512
                title: get_characters_character_id_fittings_ok
                type: array
              examples:
                response:
                  value:
                  - description: Awesome Vindi fitting
                    fitting_id: 1
                    items:
                    - flag: Cargo
                      quantity: 1
                      type_id: 1234
                    name: Best Vindicator
                    ship_type_id: 123
        '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-fittings.read_fittings.v1
      summary: EVE Online Get Fittings
      tags:
      - Fittings
      x-alternate-versions:
      - dev
      - v2
      x-cached-seconds: 300
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      description: 'Save a new fitting for a character


        ---

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


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


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


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

        '
      operationId: post_characters_character_id_fittings
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/token'
      requestBody:
        content:
          application/json:
            schema:
              description: fitting object
              properties:
                description:
                  description: description string
                  maxLength: 500
                  minLength: 0
                  title: post_characters_character_id_fittings_description
                  type: string
                items:
                  description: items array
                  items:
                    description: item object
                    properties:
                      flag:
                        description: Fitting location for the item. Entries placed in 'Invalid' will be discarded. If this leaves the fitting with nothing, it will cause an error.
                        enum:
                        - Cargo
                        - DroneBay
                        - FighterBay
                        - HiSlot0
                        - HiSlot1
                        - HiSlot2
                        - HiSlot3
                        - HiSlot4
                        - HiSlot5
                        - HiSlot6
                        - HiSlot7
                        - Invalid
                        - LoSlot0
                        - LoSlot1
                        - LoSlot2
                        - LoSlot3
                        - LoSlot4
                        - LoSlot5
                        - LoSlot6
                        - LoSlot7
                        - MedSlot0
                        - MedSlot1
                        - MedSlot2
                        - MedSlot3
                        - MedSlot4
                        - MedSlot5
                        - MedSlot6
                        - MedSlot7
                        - RigSlot0
                        - RigSlot1
                        - RigSlot2
                        - ServiceSlot0
                        - ServiceSlot1
                        - ServiceSlot2
                        - ServiceSlot3
                        - ServiceSlot4
                        - ServiceSlot5
                        - ServiceSlot6
                        - ServiceSlot7
                        - SubSystemSlot0
                        - SubSystemSlot1
                        - SubSystemSlot2
                        - SubSystemSlot3
                        title: post_characters_character_id_fittings_flag
                        type: string
                      quantity:
                        description: quantity integer
                        format: int32
                        title: post_characters_character_id_fittings_quantity
                        type: integer
                      type_id:
                        description: type_id integer
                        format: int32
                        title: post_characters_character_id_fittings_type_id
                        type: integer
                    required:
                    - type_id
                    - flag
                    - quantity
                    title: post_characters_character_id_fittings_item
                    type: object
                  maxItems: 512
                  minItems: 1
                  title: post_characters_character_id_fittings_items
                  type: array
                name:
                  description: name string
                  maxLength: 50
                  minLength: 1
                  title: post_characters_character_id_fittings_name
                  type: string
                ship_type_id:
                  description: ship_type_id integer
                  format: int32
                  title: post_characters_character_id_fittings_ship_type_id
                  type: integer
              required:
              - name
              - description
              - ship_type_id
              - items
              title: post_characters_character_id_fittings_fitting
              type: object
            examples:
              PostCharactersCharacterIdFittingsRequestExample:
                summary: Default post_characters_character_id_fittings request
                x-microcks-default: true
                value:
                  description: Example description
                  items:
                  - flag: Cargo
                    quantity: 100
                    type_id: 587
                  name: Example Name
                  ship_type_id: 587
        description: Details about the new fitting
        required: true
      responses:
        '201':
          description: A list of fittings
          content:
            application/json:
              schema:
                description: 201 created object
                properties:
                  fitting_id:
                    description: fitting_id integer
                    format: int32
                    title: post_characters_character_id_fittings_fitting_id
                    type: integer
                required:
                - fitting_id
                title: post_characters_character_id_fittings_created
                type: object
              examples:
                response:
                  value:
                    fitting_id: 2
        '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-fittings.write_fittings.v1
      summary: EVE Online Create Fitting
      tags:
      - Fittings
      x-alternate-versions:
      - dev
      - legacy
      - v1
      - v2
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /characters/{character_id}/fittings/{fitting_id}/:
    delete:
      description: 'Delete a fitting from a character


        ---

        Alternate route: `/dev/characters/{character_id}/fittings/{fitting_id}/`


        Alternate route: `/legacy/characters/{character_id}/fittings/{fitting_id}/`


        Alternate route: `/v1/characters/{character_id}/fittings/{fitting_id}/`

        '
      operationId: delete_characters_character_id_fittings_fitting_id
      parameters:
      - $ref: '#/components/parameters/character_id'
      - $ref: '#/components/parameters/datasource'
      - description: ID for a fitting of this character
        in: path
        name: fitting_id
        required: true
        schema:
          type: integer
          format: int32
        example: 1001
      - $ref: '#/components/parameters/token'
      responses:
        '204':
          description: Fitting deleted
        '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-fittings.write_fittings.v1
      summary: EVE Online Delete Fitting
      tags:
      - Fittings
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /v1/characters/{character_id}/fittings/:
    post:
      description: 'Save a new fitting for a character


        ---

        '
      operationId: post_characters_character_id_fittings
      parameters:
      - $ref: '#/parameters/character_id'
      - $ref: '#/parameters/datasource'
      - description: Details about the new fitting
        in: body
        name: fitting
        required: true
        schema:
          description: fitting object
          properties:
            description:
              description: description string
              maxLength: 500
              minLength: 0
              title: post_characters_character_id_fittings_description
              type: string
            items:
              description: items array
              items:
                description: item object
                properties:
                  flag:
                    description: Fitting location for the item. Entries placed in 'Invalid' will be discarded. If this leaves the fitting with nothing, it will cause an error.
                    enum:
                    - Cargo
                    - DroneBay
                    - FighterBay
                    - HiSlot0
                    - HiSlot1
                    - HiSlot2
                    - HiSlot3
                    - HiSlot4
                    - HiSlot5
                    - HiSlot6
                    - HiSlot7
                    - Invalid
                    - LoSlot0
                    - LoSlot1
                    - LoSlot2
                    - LoSlot3
                    - LoSlot4
                    - LoSlot5
                    - LoSlot6
                    - LoSlot7
                    - MedSlot0
                    - MedSlot1
                    - MedSlot2
                    - MedSlot3
                    - MedSlot4
                    - MedSlot5
                    - MedSlot6
                    - MedSlot7
                    - RigSlot0
                    - RigSlot1
                    - RigSlot2
                    - ServiceSlot0
                    - ServiceSlot1
                    - ServiceSlot2
                    - ServiceSlot3
                    - ServiceSlot4
                    - ServiceSlot5
                    - ServiceSlot6
                    - ServiceSlot7
                    - SubSystemSlot0
                    - SubSystemSlot1
                    - SubSystemSlot2
                    - SubSystemSlot3
                    title: post_characters_character_id_fittings_flag
                    type: string
                  quantity:
                    description: quantity integer
                    format: int32
                    title: post_characters_character_id_fittings_quantity
                    type: integer
                  type_id:
                    description: type_id integer
                    format: int32
                    title: post_characters_character_id_fittings_type_id
                    type: integer
                required:
                - type_id
                - flag
                - quantity
                title: post_characters_character_id_fittings_item
                type: object
              maxItems: 512
              minItems: 1
              title: post_characters_character_id_fittings_items
              type: array
            name:
              description: name string
              maxLength: 50
              minLength: 1
              title: post_characters_character_id_fittings_name
              type: string
            ship_type_id:
              description: ship_type_id integer
              format: int32
              title: post_characters_character_id_fittings_ship_type_id
              type: integer
          required:
          - name
          - description
          - ship_type_id
          - items
          title: post_characters_character_id_fittings_fitting
          type: object
      - $ref: '#/parameters/token'
      responses:
        '201':
          description: A list of fittings
          examples:
            application/json:
              fitting_id: 2
          schema:
            description: 201 created object
            properties:
              fitting_id:
                description: fitting_id integer
                format: int32
                title: post_characters_character_id_fittings_fitting_id
                type: integer
            required:
            - fitting_id
            title: post_characters_character_id_fittings_created
            type: object
        '400':
          description: Bad request
          examples:
            application/json:
              error: Bad request message
          schema:
            $ref: '#/definitions/bad_request'
        '401':
          description: Unauthorized
          examples:
            application/json:
              error: Unauthorized message
          schema:
            $ref: '#/definitions/unauthorized'
        '403':
          description: Forbidden
          examples:
            application/json:
              error: Forbidden message
          schema:
            $ref: '#/definitions/forbidden'
        '420':
          description: Error limited
          examples:
            application/json:
              error: Error limited message
          schema:
            $ref: '#/definitions/error_limited'
        '500':
          description: Internal server error
          examples:
            application/json:
              error: Internal server error message
          schema:
            $ref: '#/definitions/internal_server_error'
        '503':
          description: Service unavailable
          examples:
            application/json:
              error: Service unavailable message
          schema:
            $ref: '#/definitions/service_unavailable'
        '504':
          description: Gateway timeout
          examples:
            application/json:
              error: Gateway timeout message
          schema:
            $ref: '#/definitions/gateway_timeout'
      security:
      - evesso:
        - esi-fittings.write_fittings.v1
      summary: Create fitting
      tags:
      - Fittings
      x-alternate-versions:
      - latest
      - legacy
      - v1
      - v2
  /v1/characters/{character_id}/fittings/{fitting_id}/:
    delete:
      description: 'Delete a fitting from a character


        ---

        '
      operationId: delete_characters_character_id_fittings_fitting_id
      parameters:
      - $ref: '#/parameters/character_id'
      - $ref: '#/parameters/datasource'
      - description: ID for a fitting of this character
        format: int32
        in: path
        name: fitting_id
        required: true
        type: integer
      - $ref: '#/parameters/token'
      responses:
        '204':
          description: Fitting deleted
        '400':
          description: Bad request
          examples:
            application/json:
              error: Bad request message
          schema:
            $ref: '#/definitions/bad_request'
        '401':
          description: Unauthorized
          examples:
            application/json:
              error: Unauthorized message
          schema:
            $ref: '#/definitions/unauthorized'
        '403':
          description: Forbidden
          examples:
            application/json:
              error: Forbidden message
          schema:
            $ref: '#/definitions/forbidden'
        '420':
          description: Error limited
          examples:
            application/json:
              error: Error limited message
          schema:
            $ref: '#/definitions/error_limited'
        '500':
          description: Internal server error
          examples:
            application/json:
              error: Internal server error message
          schema:
            $ref: '#/definitions/internal_server_error'
        '503':
          description: Service unavailable
          examples:
            application/json:
              error: Service unavailable message
          schema:
            $ref: '#/definitions/service_unavailable'
        '504':
          description: Gateway timeout
          examples:
            application/json:
              error: Gateway timeout message
          schema:
            $ref: '#/definitions/gateway_timeout'
      security:
      - evesso:
        - esi-fittings.write_fittings.v1
      summary: Delete fitting
      tags:
      - Fittings
      x-alternate-versions:
      - latest
      - legacy
      - v1
  /v2/characters/{character_id}/fittings/:
    get:
      description: 'Return fittings of a character


        ---


        This route is cached for up to 300 seconds'
      operationId: get_characters_character_id_fittings
      parameters:
      - $ref: '#/parameters/character_id'
      - $ref: '#/parameters/datasource'
      - $ref: '#/parameters/If-None-Match'
      - $ref: '#/parameters/token'
      responses:
        '200':
          description: A list of fittings
          examples:
            application/json:
            - description: Awesome Vindi fitting
              fitting_id: 1
              items:
              - flag: Cargo
                quantity: 1
                type_id: 1234
              name: Best Vindicator
              ship_type_id: 123
          headers:
            Cache-Control:
              description: The caching mechanism used
              type: string
            ETag:
              description: RFC7232 compliant entity tag
              type: string
            Expires:
              description: RFC7231 formatted datetime string
              type: string
            Last-Modified:
              description: RFC7231 formatted datetime string
              type: string
          schema:
            description: 200 ok array
            items:
              description: 200 ok object
              properties:
                description:
                  description: description string
                  title: get_characters_character_id_fittings_description
                  type: string
                fitting_id:
                  description: fitting_id integer
                  format: int32
                  title: get_characters_character_id_fittings_fitting_id
                  type: integer
                items:
                  description: items array
                  items:
                    description: item object
                    properties:
                      flag:
                        description: flag string
                        enum:
                        - Cargo
                        - DroneBay
                        - FighterBay
                        - HiSlot0
                        - HiSlot1
                        - HiSlot2
                        - HiSlot3
                        - HiSlot4
                        - HiSlot5
                        - HiSlot6
                        - HiSlot7
                        - Invalid
                        - LoSlot0
                        - LoSlot1
                        - LoSlot2
                        - LoSlot3
                        - LoSlot4
                        - LoSlot5
                        - LoSlot6
                        - LoSlot7
                        - MedSlot0
                        - MedSlot1
                        - MedSlot2
                        - MedSlot3
                        - MedSlot4
                        - MedSlot5
                        - MedSlot6
                        - MedSlot7
                        - RigSlot0
                        - RigSlot1
                        - RigSlot2
                        - ServiceSlot0
                        - Se

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