REST API · v1

DayZ Item API

The entire item database as JSON – free to use with a personal API key. For Discord bots, server tools, overlays and your own projects.

Access & fair use

All /api/v1 endpoints require a free API key – it keeps abuse out and makes fair rate limits possible. No subscription needed.

Sign in with Discord – the account itself is free.
Create a free API key in your settings.
Create an API key and send it with every request.

# Empfohlen / recommended
curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm"

# Alternative
curl -H "X-Api-Key: dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Keep your key secret: call the API from your server, bot or backend – anyone who has the key uses your quota. You can revoke a key in the settings at any time and create a new one; the old one stops working immediately.

Need more throughput? Optional supporter subscription

For €3.99/month you support the running server costs and your rate limit rises from 60 to 300 requests per minute. Cancel monthly in the customer portal.

The game data itself is and stays freely accessible for everyone – the supporter subscription only pays for server capacity (a higher rate limit), never for the data. DayZ and its game data belong to Bohemia Interactive a.s.

Manage subscription & keys

API key required

Send the key as "Authorization: Bearer" or "X-Api-Key" header with every request.

60 → 300 requests/min

Free: 60 requests per minute per key. With the optional supporter subscription: 300/min. Every response carries X-RateLimit headers incl. X-RateLimit-Tier.

Real game data

Extracted straight from the DayZ configs, updated after game patches.

GET`/api/v1/items`

Search and filter items (paginated)

Parameter	Description
q	Search in name and class name (fuzzy)
cat	Category, e.g. Weapon, Food / Drink, Ammo
tier	Loot tier: Tier1 – Tier4 or Unique
sort	name (default), damage, rpm or weight
page	Page, starting at 1
limit	Results per page, 1–100 (default 48)
icons	1 = only items with an icon
lang	Language of the name field: en, de, fr, es, it (default en)

curl -H "Authorization: Bearer dzp_YOUR_KEY" \
  "https://dzpage.com/api/v1/items?q=akm&limit=5&lang=en"

{
  "meta": { "total": 12, "page": 1, "pages": 3, "limit": 5 },
  "items": [
    {
      "class_name": "AKM",
      "slug": "akm",
      "name": "KA-M",
      "category": "Weapon",
      "has_icon": true,
      "weight": 2140,
      "size_w": 8, "size_h": 3,
      "loot_tiers": ["Tier4"],
      "damage": 9.5,
      "icon": "https://dzpage.com/icons/full/AKM.png",
      "icon_thumb": "https://dzpage.com/icons/thumb/AKM.webp",
      "url": "https://dzpage.com/en/items/akm"
    }
  ]
}

GET`/api/v1/items/{class_name}`

Single item with all details

Accepts class names (case-insensitive) or slugs. Returns every field: weapon stats, ammo, magazines, attachments, loot data, spawn buildings, recipes, all localized names and the complete raw config data.

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/items/AKM?lang=en"

// JavaScript (Node.js, Discord-Bot, …)
const res = await fetch("https://dzpage.com/api/v1/items/AKM", {
  headers: { Authorization: "Bearer " + process.env.DZPAGE_API_KEY },
});
const { item } = await res.json();
console.log(item.names.en, item.weapon_stats.rpm_full_auto);

GET`/api/v1/categories`

All categories with item counts

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/categories"

GET`/api/v1/meta`

Dataset info: import date, item count, game build

curl -H "Authorization: Bearer dzp_YOUR_KEY" "https://dzpage.com/api/v1/meta"

Errors, limits & stability

Errors are always JSON with a stable error code, a human-readable message and a docs link:

{
  "error": "invalid_api_key",
  "message": "Invalid or revoked API key. …",
  "docs": "https://dzpage.com/api"
}

Status · code	Meaning
401 · missing_api_key	No API key sent. Add the "Authorization: Bearer" or "X-Api-Key" header.
401 · invalid_api_key	The key does not exist or has been revoked.
404 · not_found	No item with this class name or slug.
429 · rate_limited	Rate limit exhausted – wait Retry-After seconds, then try again.
5xx	Server error – safe to retry. If it persists, report it on our Discord.

Every successful response includes rate-limit headers so your client can throttle itself:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1789000000
Retry-After: 31   (nur bei 429 / only on 429)

Ground rules

One subscription covers your own projects, bots and server tools – fair use within the rate limit.
If you use this in your own projects, a link back to dzpage.com is appreciated.
Item icons (icon / icon_thumb URLs) remain freely hotlinkable – they are cached long-term and need no key.
This API is v1: fields may be added, existing fields won't be removed or renamed.

Access & fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories