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. The key costs nothing.

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.

The game data is and stays freely accessible for everyone – the API is free and will never be paid. DayZ and its game data belong to Bohemia Interactive a.s.

Manage API keys

API key required

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

60 → 300 requests/min

60 requests per minute per key. Every response carries X-RateLimit headers.

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, ru, pl, cs, pt, zh (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 key 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.

Loading …

Preparing your tool

Access & fair use

All /api/v1 endpoints require a free API key – it keeps abuse out and makes fair rate limits possible. The key costs nothing.

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"

The game data is and stays freely accessible for everyone – the API is free and will never be paid. DayZ and its game data belong to Bohemia Interactive a.s.

Manage API keys

Parameter

Description

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, ru, pl, cs, pt, zh (default 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" } ] }

// 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);

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 key 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

GET/api/v1/meta

Errors, limits & stability

Ground rules

Access & fair use

GET/api/v1/items

GET/api/v1/items/{class_name}

GET/api/v1/categories

GET/api/v1/meta

Errors, limits & stability

Ground rules

GET`/api/v1/items`

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

GET`/api/v1/categories`

GET`/api/v1/meta`

GET`/api/v1/items`

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

GET`/api/v1/categories`

GET`/api/v1/meta`