Helldivers 2 API Guide

Version: 0.0.1
Base URL:

https://helldivers-2.fly.dev/api

Overview Copied!

The Helldivers 2 API provides developers with access to game data, including details about war seasons, global events, planets, and news feeds. This guide includes information on how to utilize these endpoints effectively.

Authentication Copied!

This API specification does not include authentication details. Users should consult official documentation or contact support for information on accessing protected resources.

Rate Limits Copied!

To ensure equitable access, the API implements rate limiting. Headers in responses indicate your usage, limit, and the reset time. Exceeding these limits results in a

429 Too Many Requests

status code.

Endpoints Copied!

War Seasons

GET /
Retrieves an overview of all available war seasons.
- Responses
  - 200 : War season overview.
  - 429 : Rate limit exceeded.

Global Events

GET /{war_id}/events
Overview of global events for a specified war season.
- Parameters
  - war_id (path): The ID of the war.
- Responses
  - 200 : Global events data.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.
GET /{war_id}/events/latest
Details of the latest global event.
- Parameters
  - war_id (path): The war's ID.
- Responses
  - 200 : Latest global event data.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.

News Feed

GET /{war_id}/feed
The in-game 'Dispatch' newsfeed.
- Parameters
  - war_id (path): The ID of the war.
- Responses
  - 200 : Newsfeed content.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.

Planets

GET /{war_id}/planets
An overview of planets for the specified war season.
- Parameters
  - war_id (path): The war ID.
- Responses
  - 200 : List of planets.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.
GET /{war_id}/planets/{planet_index}
Information on a specific planet.
- Parameters
  - war_id (path): The war ID.
  - planet_index (path): The planet's index.
- Responses
  - 200 : Planet details.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.
GET /{war_id}/planets/{planet_index}/status
Current war status of a specific planet.
- Parameters
  - war_id (path): The war ID.
  - planet_index (path): The planet's index.
- Responses
  - 200 : Planet status.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.

War Information

GET /{war_id}/info
Information for a specific war season.
- Parameters
  - war_id (path): The war ID.
- Responses
  - 200 : War information.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.
GET /{war_id}/status
The current status of the Helldivers offensive.
- Parameters
  - war_id (path): The war ID.
- Responses
  - 200 : War status.
  - 404 : Resource not found.
  - 429 : Rate limit exceeded.

Schemas Copied!

Detailed descriptions for entities like

CampaignSchema

GlobalEventSchema

PlanetSchema

, and others are provided in the API documentation. These schemas detail the structure and types of data returned by the API, including fields such as

id

type

planet

, and

message