Inara API

More about Inara API is on the API page, general dev guidelines are here and more detailed documentation about the events and data format here.

Just a note for tool authors using Inara API - please ensure your apps are doing  TWO requests per minute AT MAXIMUM. As I have discovered, many users are using multiple apps at once (nothing wrong with that), but are also updating their profiles from all of the applications at once, which is causing quite serious overhead. For such reason, I have needed to make API requests limits much tighter. For bots and other similar non-demanding apps are requests rates set same as before. If do you need another requests rate limit, please send me a PM.

Inara API update for Odyssey:
  • The header property isDeveloped was renamed to less confusing isBeingDeveloped. You don't need to change anything on your end though, the old property will still work.
  • A new event addCommanderTravelLand for commanders landing on the celestial body was added (should be triggered at journal's Touchdown, DropShipDeploy and similar).
  • The events addCommanderTravelCarrierJump, addCommanderTravelDock, addCommanderTravelFSDJump and setCommanderTravelLocation now contain optional properties for the star system coordinates, celestial body and celestial body coordinates. It's not required to set, it may however help to further precise commander's location when the star system is not in the database, etc.
  • The events addCommanderTravelDock, addCommanderTravelFSDJump and addCommanderTravelLand are now having boolean properties isTaxiShuttle and isTaxiDropship for travelling with Apex or Frontline Solutions ships.
  • New events setCommanderInventory, resetCommanderInventory, setCommanderInventoryItem, addCommanderInventoryItem and delCommanderInventoryItem added. Those are supposed for handling the new Odyssey events like ShipLockerMaterials and similar, you can however use it also for the existing engineering materials or ship cargo instead of the existing dedicated events (but you do not need to, they are not going anywhere).
  • New events setCommanderSuitLoadout, updateCommanderSuitLoadout and delCommanderSuitLoadout for the suit loadouts added.
17 Apr 2022, 10:30am
MeLikeFishQuick question. How does Inara get its commodity data?

From the EDDN network, which distributes game data between tools and sites - it's being fed by tools like EDMC, EDDiscovery, EDDI, etc.
They send the data at the in-game market screen opening to EDDN which then is being "consumed" and used by Inara, EDDB, EDSM and so on.
30 Jul 2022, 9:20pm
How often is the data from my computer updated into INARA?
30 Jul 2022, 10:17pm
It depends, on auto-updates once a day (you can import manually by clicking the button, too), from Frontier's server. If you are using EDMC, EDDiscovery and similar, then almost real-time via Inara API, from your local computer.
25 Aug 2022, 12:32pm
Hey there,

I am just creating a squadron website (wordpress) and was wondering if there is any possibility to import the rooster data from Inara?

I just want to create a simple table to show the data.


Any hints or codes snippets I could use?
26 Aug 2022, 8:53am
Hello,
no such output in the API, I am afraid.
10 Oct 2022, 8:21am
does anyone has also issues with EDMC not updating Inara anymore?
it seems to work a few times and then just stop working, using EDDiscovery with the same key works just fine.

(not updated the client)
17 Oct 2022, 5:04am
Hey guys!

Anyone have any luck getting odyssey settlements to update with the API?
17 Oct 2022, 11:48am
The settlements, stations, star systems, etc. aren't updated via API. It gets updated via EDDN (tools like EDMC, EDDiscovery, etc. are sending the respective data) and on direct journal imports via "Import game data" on your CMDR page.
17 Oct 2022, 2:41pm
aaaah I see, Thanks a ton! =D
26 Nov 2022, 1:15pm
For all app authors utilizing Inara API: As Inara will be supporting only Live data (so Odyssey and Horizons 4.0), there is recommended for any app using Inara API to update commander's data to send just Live data via API. You can simply implement a killswitch based on the journal's 'gameversion' property (or any other relevant property that may appear in the journal with the U14), to ensure just Live data will be sent.

On the game update 14 release day, I will disable all Inara API updates temporarily and will put it back on once there will be clear everything works as expected. Also, when you implement this data split in your apps, please let me know your app version containing the changes, so I can enforce that version for all API updates. This is relevant only for the apps updating CMDR's data, of course (other apps don't need to take any actions).
06 Apr 2023, 4:02pm
With eddb.io going away this weekend.. does Inara have any API endpoints where we can fetch galaxy data similar to the following? I didn't see anything as such advertised in the documentation here.

https://eddb.io/archive/v6/systems_populated.json
https://eddb.io/archive/v6/stations.json
https://eddb.io/archive/v6/factions.json
https://eddb.io/archive/v6/commodities.json

EDDB.io doc: https://eddb.io/api
06 Apr 2023, 4:50pm
Nope. But you can easily have your data updated from the EDDN as every major tool does (and utilize existing EDDB's dump as a starting point, if you will be building it from the scratch). Some API and/or dumps for the galactic data and stations are being provided by EDSM and Spansh, too.

Last edit: 06 Apr 2023, 5:00pm
06 Apr 2023, 5:27pm
Thank you!
27 Jun 2023, 12:58pm
Hello Artie, it's been a while.

Quick question regarding the API, specifically the getCommanderProfile event.

When a CMDR is searched for, and data is returned and the CMDR has a squadron, two bits of data is returned in the response which contain the same data;


"commanderSquadron"
"commanderWing"


Is one of these sections being depreciated? Apologies if this has been asked before!

Thanks
27 Jun 2023, 1:13pm
Yes, the 'commanderWing' is deprecated, it's there only for the backward compatibility, so please use the 'commanderSquadron' property.

Post a reply

You must be signed in to post here.
Inara API is... well... see sticky post for the details.