The Forge API

Build tools for the Single Player Tarkov community on top of the same data that powers Forge. Every endpoint is publicly accessible and requires no authentication or API key.

No authentication Read-only JSON ~300 req/min OpenAPI + Postman

Base URL

https://forge.sp-tarkov.com/api/v0

Your first request

No setup, no key, no sign-up. Paste this into a terminal and you are talking to the API in seconds. The full reference shows the same examples in JavaScript, PHP, and Python.

Request

curl "https://forge.sp-tarkov.com/api/v0/mods?per_page=1"

Response 200 OK

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Raid Time Adjuster",
      "slug": "raid-time-adjuster",
      "downloads": 55212644,
      "fika_compatibility": true
    }
  ],
  "links": { "next": null, "prev": null },
  "meta": { "current_page": 1, "per_page": 1, "total": 842 }
}

What you can build

Mod managers & browsers

List, search, and filter the full catalogue by category, SPT version, or Fika support, with pagination built in.

Update checkers

Compare a user's installed mods against the latest published versions and tell them exactly what is out of date.

Dependency resolvers

Resolve a mod or addon's full dependency tree before install so nothing is left missing.

Compatibility tooling

Filter mods by an SPT SemVer constraint or Fika compatibility to surface only what works with a given build.

Bots & dashboards

Pull download counts, featured flags, and categories into Discord bots, stat sites, or community dashboards.

Whatever you dream up

The data is open. If you build something neat with it, come share it with us on Discord.

Resource map

Mods

List and inspect mods, versions, dependencies, and updates.

GET /mods List mods

GET /mod/{id} Mod details

GET /mod/{id}/versions Version history

GET /mod/{id}/versions/{versionId}/file-tree Verified file listing

GET /mods/dependencies Resolve dependencies

GET /mods/updates Check for updates

Addons

The same shape as mods, for addon packages.

GET /addons List addons

GET /addon/{id} Addon details

GET /addon/{id}/versions Version history

GET /addon/{id}/versions/{versionId}/file-tree Verified file listing

GET /addons/dependencies Resolve dependencies

Categories & SPT versions

Reference data for filters and compatibility.

GET /mod-categories List categories

GET /mod-categories/{id} Category details

GET /spt/versions SPT versions

Health

Uptime and connectivity checks.

GET /ping Health check

A note on stability

The API is versioned and currently sits at v0. It is in active development, so fields and behaviour may change as it matures. Pin to the versioned base path, and watch our Discord for announcements before you ship anything you intend to support long term.

Be a good citizen

Cache responses and avoid polling harder than you need to.
Send a descriptive User-Agent so we can reach you if needed.
Respect the rate limit and our Terms of Service.

Ready to build?

Dive into the full reference, grab the spec or Postman collection, or come ask questions and show off what you are building.

Read the full reference OpenAPI spec Postman collection Ask on Discord