This is subject to change. Documentation & API written October 4th, 2016.
If you need to do some testing on our API, please use the http://beta.edsm.net:8080/ endpoint.
It is usually up to date with the production database, but if not, send us a message.
Name of the system(s) you want information about. This is case-insensitive as ingame.
Spaces and other special characters in the system's name must be URL encoded.
If you call the API from within a browser, it should be encoded automatically.
If you are writing some 3rd party app, you probably know what to do. In PHP use urlencode.
Use the percent sign "%" for a wildcard.
|coords||Set to 1 if you want to get the coordinates (if known).|
Set to 1 if you want to get our internal id.
Additionally, you can receive a mergedTo id, indicating that the current system was renamed and merge to another system.
|showPermit||Set to 1 if you want to see if a system require a permit to be entered. Also return the name of the permit when known.|
|showInformation||Set to 1 if you want to get some basic information about populated systems, like government, allegiance, population...|
|pushed||Set to 1 if you want to get only systems that are pushed on our homepage.|
|known||Set to 1 if you want to get only systems with known coordinates.|
|unknown||Set to 1 if you want to get only systems with unknown coordinates.|
|distances||Set to 1 if you want to receive the submitted distances.|
|submitted||Set to 1 if you want to receive information who and when submitted the names and distances.|
If you only want to receive data for systems that were updated after a specific date & time, use this parameter.
That parameter is inclusive. All dates must be UTC.
If you only want to receive data for systems that were updated before a specific date & time, use this parameter.
That parameter is exclusive. All dates must be UTC.
Set to 1 if you want to see the known errors.
One possible error is a submitted distance to another system where both coordinates are known, and the submitted distance is not the same as the calculated distance.
This is probably a CMDR's typo when submitting distances.
Another error is when more than one distance was submitted to the same reference system.
Both are problematic because they may prevent coordinate calculation, show former wrong calculations or other bad things like moved systems.
|reqdists||If you want to help finding new coordinates, set this to the number of systems you want to see where distances are needed. You get an array "reqlocatedists" with unknown systems.|