Helldivers 2 API
The API grants you access to real-time battle data, empowering you to spread the word of our noble cause across the galaxy. Use it to share updates, rally allies, and showcase our progress in the fight for democracy. Let's unite the galaxy in our mission to eradicate tyranny and usher in a new era of peace and democracy. Together, we can ignite the flames of liberty across the stars!
Endpoints
There are several endpoints available. Each returns data as JSON.
https://helldiverstrainingmanual.com/api/v1/war/status
Provides the current status of all planets along with their player count. This is returned as is from an official endpoint.
https://helldiverstrainingmanual.com/api/v1/war/info
Provides static info of planet listed by their index. This is returned as is from an official endpoint.
https://helldiverstrainingmanual.com/api/v1/war/news
Provides a news feed of messages that are delivered in-game. Only 10 items are returned at a time, from oldest to newest. This means you might miss out on newer items if there are more than 10 lined up. You can pass ?from=[time]
to retrieve news from a certain time. This time should match the time given in other endpoints such as /status
and /info
. This is returned as is from an official endpoint.
https://helldiverstrainingmanual.com/api/v1/war/campaign
Provides a shorter and more ready to handle list of all current active planets.
https://helldiverstrainingmanual.com/api/v1/war/history/[planetIndex]
Provides the liberation history of a given planet. Returns the liberation status in 5 minutes intervals (with some variance). Status is only recorded when planet is active, as a result there may be big jumps between dates. Ordered from newest to latest, limited to 288 results (24 hours). The limit can be adjusting using ?timeframe=[short|day]
. short
Returns only 2 records. The options week
and month
are in the works but are not currently available.
https://helldiverstrainingmanual.com/api/v1/war/major-orders
Provides the currently active Major Order(s). This endpoint is straight from the official API and can be confusing to use at times. The index of the currently active planets can be found using each task values[2] value. The way tasks are structured can change between different major orders.
https://helldiverstrainingmanual.com/api/v1/planets
Provides data about each planet, the first key matches the planet index.The data includes information about the conditions and type of planet. The type of planet is listed as
biome
. The names of the biomes are not names from the game, they are made up. Some biomes will be null
because the type is not known yet. Environmentals almost always match the biome. For example, a desert biome will always have Intense Heat and Tremors. The only exception to this currently is Tien Kwan. More exceptions could happen in the future, which is why Environmentals are listed separately from the Biome itself.
Know the risks
The data comes from an official endpoint, but it's not an officially open API. It's entirely possible it will stop working at some point.
There is no authentication or rate limiting. Handle it with respect, soldier.
This API is subject to change. Use at your own risk.