EVE Online

EVE Online Loyalty API

The Loyalty API from EVE Online — 4 operation(s) for loyalty.

GitHub OpenAPI

Operations 4

GET /characters/{character_id}/loyalty/points/ EVE Online Get Loyalty Points #
GET /loyalty/stores/{corporation_id}/offers/ EVE Online List Loyalty Store Offers #
GET /v1/characters/{character_id}/loyalty/points/ Get loyalty points #
GET /v1/loyalty/stores/{corporation_id}/offers/ List loyalty store offers #

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-loyalty-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

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-loyalty-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

eve-online-loyalty-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Eve Online Loyalty API
  version: '1.36'
  description: 'Operations tagged Loyalty 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: Loyalty
paths:
  /characters/{character_id}/loyalty/points/:
    get:
      description: 'Return a list of loyalty points for all corporations the character has worked for


        ---

        Alternate route: `/dev/characters/{character_id}/loyalty/points/`


        Alternate route: `/legacy/characters/{character_id}/loyalty/points/`


        Alternate route: `/v1/characters/{character_id}/loyalty/points/`


        ---

        This route is cached for up to 3600 seconds'
      operationId: get_characters_character_id_loyalty_points
      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 loyalty points
          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:
                    corporation_id:
                      description: corporation_id integer
                      format: int32
                      title: get_characters_character_id_loyalty_points_corporation_id
                      type: integer
                    loyalty_points:
                      description: loyalty_points integer
                      format: int32
                      title: get_characters_character_id_loyalty_points_loyalty_points
                      type: integer
                  required:
                  - corporation_id
                  - loyalty_points
                  title: get_characters_character_id_loyalty_points_200_ok
                  type: object
                maxItems: 500
                title: get_characters_character_id_loyalty_points_ok
                type: array
              examples:
                response:
                  value:
                  - corporation_id: 123
                    loyalty_points: 100
        '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-characters.read_loyalty.v1
      summary: EVE Online Get Loyalty Points
      tags:
      - Loyalty
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-cached-seconds: 3600
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /loyalty/stores/{corporation_id}/offers/:
    get:
      description: 'Return a list of offers from a specific corporation''s loyalty store


        ---

        Alternate route: `/dev/loyalty/stores/{corporation_id}/offers/`


        Alternate route: `/legacy/loyalty/stores/{corporation_id}/offers/`


        Alternate route: `/v1/loyalty/stores/{corporation_id}/offers/`


        ---

        This route expires daily at 11:05'
      operationId: get_loyalty_stores_corporation_id_offers
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: A list of offers
          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:
                    ak_cost:
                      description: Analysis kredit cost
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_ak_cost
                      type: integer
                    isk_cost:
                      description: isk_cost integer
                      format: int64
                      title: get_loyalty_stores_corporation_id_offers_isk_cost
                      type: integer
                    lp_cost:
                      description: lp_cost integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_lp_cost
                      type: integer
                    offer_id:
                      description: offer_id integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_offer_id
                      type: integer
                    quantity:
                      description: quantity integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_quantity
                      type: integer
                    required_items:
                      description: required_items array
                      items:
                        description: required_item object
                        properties:
                          quantity:
                            description: quantity integer
                            format: int32
                            title: get_loyalty_stores_corporation_id_offers_required_item_quantity
                            type: integer
                          type_id:
                            description: type_id integer
                            format: int32
                            title: get_loyalty_stores_corporation_id_offers_required_item_type_id
                            type: integer
                        required:
                        - type_id
                        - quantity
                        title: get_loyalty_stores_corporation_id_offers_required_item
                        type: object
                      maxItems: 100
                      title: get_loyalty_stores_corporation_id_offers_required_items
                      type: array
                    type_id:
                      description: type_id integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_type_id
                      type: integer
                  required:
                  - offer_id
                  - type_id
                  - quantity
                  - lp_cost
                  - isk_cost
                  - required_items
                  title: get_loyalty_stores_corporation_id_offers_200_ok
                  type: object
                maxItems: 10000
                title: get_loyalty_stores_corporation_id_offers_ok
                type: array
              examples:
                response:
                  value:
                  - ak_cost: 35000
                    isk_cost: 0
                    lp_cost: 100
                    offer_id: 1
                    quantity: 1
                    required_items: []
                    type_id: 123
                  - isk_cost: 1000
                    lp_cost: 100
                    offer_id: 2
                    quantity: 10
                    required_items:
                    - quantity: 10
                      type_id: 1234
                    type_id: 1235
        '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: No loyalty point store found for the provided corporation
          content:
            application/json:
              schema:
                description: Not found
                properties:
                  error:
                    description: Not found message
                    title: get_loyalty_stores_corporation_id_offers_404_not_found
                    type: string
                title: get_loyalty_stores_corporation_id_offers_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 List Loyalty Store Offers
      tags:
      - Loyalty
      x-alternate-versions:
      - dev
      - legacy
      - v1
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    servers:
    - url: https://esi.evetech.net/latest
  /v1/characters/{character_id}/loyalty/points/:
    get:
      description: 'Return a list of loyalty points for all corporations the character has worked for


        ---


        This route is cached for up to 3600 seconds'
      operationId: get_characters_character_id_loyalty_points
      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 loyalty points
          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:
                    corporation_id:
                      description: corporation_id integer
                      format: int32
                      title: get_characters_character_id_loyalty_points_corporation_id
                      type: integer
                    loyalty_points:
                      description: loyalty_points integer
                      format: int32
                      title: get_characters_character_id_loyalty_points_loyalty_points
                      type: integer
                  required:
                  - corporation_id
                  - loyalty_points
                  title: get_characters_character_id_loyalty_points_200_ok
                  type: object
                maxItems: 500
                title: get_characters_character_id_loyalty_points_ok
                type: array
              example:
              - corporation_id: 123
                loyalty_points: 100
        '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-characters.read_loyalty.v1
      summary: Get loyalty points
      tags:
      - Loyalty
      x-alternate-versions:
      - latest
      - legacy
      - v1
      x-cached-seconds: 3600
    servers:
    - url: https://esi.evetech.net
  /v1/loyalty/stores/{corporation_id}/offers/:
    get:
      description: 'Return a list of offers from a specific corporation''s loyalty store


        ---


        This route expires daily at 11:05'
      operationId: get_loyalty_stores_corporation_id_offers
      parameters:
      - $ref: '#/components/parameters/corporation_id'
      - $ref: '#/components/parameters/datasource'
      - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: A list of offers
          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:
                    ak_cost:
                      description: Analysis kredit cost
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_ak_cost
                      type: integer
                    isk_cost:
                      description: isk_cost integer
                      format: int64
                      title: get_loyalty_stores_corporation_id_offers_isk_cost
                      type: integer
                    lp_cost:
                      description: lp_cost integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_lp_cost
                      type: integer
                    offer_id:
                      description: offer_id integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_offer_id
                      type: integer
                    quantity:
                      description: quantity integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_quantity
                      type: integer
                    required_items:
                      description: required_items array
                      items:
                        description: required_item object
                        properties:
                          quantity:
                            description: quantity integer
                            format: int32
                            title: get_loyalty_stores_corporation_id_offers_required_item_quantity
                            type: integer
                          type_id:
                            description: type_id integer
                            format: int32
                            title: get_loyalty_stores_corporation_id_offers_required_item_type_id
                            type: integer
                        required:
                        - type_id
                        - quantity
                        title: get_loyalty_stores_corporation_id_offers_required_item
                        type: object
                      maxItems: 100
                      title: get_loyalty_stores_corporation_id_offers_required_items
                      type: array
                    type_id:
                      description: type_id integer
                      format: int32
                      title: get_loyalty_stores_corporation_id_offers_type_id
                      type: integer
                  required:
                  - offer_id
                  - type_id
                  - quantity
                  - lp_cost
                  - isk_cost
                  - required_items
                  title: get_loyalty_stores_corporation_id_offers_200_ok
                  type: object
                maxItems: 10000
                title: get_loyalty_stores_corporation_id_offers_ok
                type: array
              example:
              - ak_cost: 35000
                isk_cost: 0
                lp_cost: 100
                offer_id: 1
                quantity: 1
                required_items: []
                type_id: 123
              - isk_cost: 1000
                lp_cost: 100
                offer_id: 2
                quantity: 10
                required_items:
                - quantity: 10
                  type_id: 1234
                type_id: 1235
        '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
        '404':
          description: No loyalty point store found for the provided corporation
          content:
            application/json:
              schema:
                description: Not found
                properties:
                  error:
                    description: Not found message
                    title: get_loyalty_stores_corporation_id_offers_404_not_found
                    type: string
                title: get_loyalty_stores_corporation_id_offers_not_found
                type: object
              example:
                error: Not found 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
      summary: List loyalty store offers
      tags:
      - Loyalty
      x-alternate-versions:
      - latest
      - legacy
      - v1
    servers:
    - url: https://esi.evetech.net
components:
  schemas:
    unauthorized:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
          example: example
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
          example: example
      required:
      - error
      title: Service unavailable
      type: object
    error_limited:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
          example: example
      required:
      - error
      title: Error limited
      type: object
    bad_request:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
          example: example
      required:
      - error
      title: Bad request
      type: object
    internal_server_error:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
          example: example
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
          example: example
        timeout:
          description: number of seconds the request was given
          type: integer
          example: 1
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
          example: example
        sso_status:
          description: status code received from SSO
          type: integer
          example: 1
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_2:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_2:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_2:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_2:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_2:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_2:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_2:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_3:
      description: Unauthorized model
      properties:
        error:
          description: Unauthorized message
          type: string
      required:
      - error
      title: Unauthorized
      type: object
    service_unavailable_3:
      description: Service unavailable model
      properties:
        error:
          description: Service unavailable message
          type: string
      required:
      - error
      title: Service unavailable
      type: object
    error_limited_3:
      description: Error limited model
      properties:
        error:
          description: Error limited message
          type: string
      required:
      - error
      title: Error limited
      type: object
    bad_request_3:
      description: Bad request model
      properties:
        error:
          description: Bad request message
          type: string
      required:
      - error
      title: Bad request
      type: object
    internal_server_error_3:
      description: Internal server error model
      properties:
        error:
          description: Internal server error message
          type: string
      required:
      - error
      title: Internal server error
      type: object
    gateway_timeout_3:
      description: Gateway timeout model
      properties:
        error:
          description: Gateway timeout message
          type: string
        timeout:
          description: number of seconds the request was given
          type: integer
      required:
      - error
      title: Gateway timeout
      type: object
    forbidden_3:
      description: Forbidden model
      properties:
        error:
          description: Forbidden message
          type: string
        sso_status:
          description: status code received from SSO
          type: integer
      required:
      - error
      title: Forbidden
      type: object
    unauthorized_4:
      description: Unauthorized model
   

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