ESI Documentation

ESI is the name of EVE Online's publicly available API, allowing you to query the game itself to get info about your character, corporation and more. This documentation can be used as a jumping off point to learn how to begin developing against ESI or as a place to learn some of the ESI concepts that are harder to grasp.

We appreciate help from the EVE Online community and encourage pull requests if you feel any documentation is missing. Our wonderful ESI community helps to moderate this documentation.

Important Online Resources

The following is a list of important online resources for ESI development.

• Watch the third party developer blog for updates about ESI.
• Make bug or feature requests at our esi-issues Github page.
• For real time discussion about ESI join us on our #esi channel in Slack by following these instructions.
• Watch the ESI changelog for upcoming endpoint changes. Updates are broadcast in the #esi channel, or you can subscribe to email notifications.

Table of Contents

If you're adding a new document, please be sure to include a link here somewhere.

General

• ESI Introduction
• Frequently Asked Questions
• Transitioning from XML
• Transitioning from CREST
• What defines a breaking change
• Warning headers explained
• ESI scrapes

Using ESI Data

• Dogma
• ID Ranges
• Useful Formulae
• Asset location_id
• Notifications

Common Scenarios

• Resolve Structure IDs
• Retrieve Structure Markets

SSO

• Introduction
• High level overview of SSO authorization flow
• Creating an EVE Online SSO application
• OAuth 2.0 for web based applications
• OAuth 2.0 for desktop/mobile applications
• Refreshing access tokens
• Validating EVE SSO JWT tokens
• Sending authenticated requests to ESI
• Migrating from SSO v1 to v2
• Old documentation

Other Resources

• Static Data Export
  • SDE Conversions
  • SDE Complements
• Image Server

Community FAQs

• Guidelines
• Best Practices
• Quick URL Reference
• Developer License