Sign in Sign up

API Documentation

Retrieve your data via a simple, plan-limited API key

Quick start

All endpoints are prefixed with /api/v1 and require an API key.

Auth Filters Endpoints
Example: check your plan limits
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/me"

Responses are JSON. Collection endpoints return data plus pagination links + meta.

Example: filter events by time + player
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dzloggy.com/api/v1/instances/INSTANCE_SID/admin-log-events?per_page=50&page=1&event=PLAYER_SPAWN&player_steam_id=7656...&date_from=2025-12-01T00:00:00Z&date_to=2025-12-26T23:59:59Z"

Use ISO-8601 timestamps for date_from/date_to (UTC recommended).

Authentication

Send your API key using X-API-Key or Authorization: Bearer. API access is enabled for paid plans only.

Your API Key

Sign in to view your API key.

Plan Limits
Free API disabled
Gold Enabled
100 / min
10,000 / day
30 days retention
Max 50 / page
Platinum Enabled
10,000 / min
200,000 / day
90 days retention
Max 500 / page

Retention is enforced on all API queries, even if you request older dates.

Filtering & pagination

Pagination
  • page: 1-based page index
  • per_page: items per page (capped by your plan)
Ordering
  • order_by: field to order results by (endpoint-specific allowlist)
  • order_dir: asc or desc
Event filters
  • event: event type name (example: PLAYER_SPAWN)
  • sub_event: sub event type name
  • player_steam_id: SteamID64 string
  • date_from/date_to: ISO-8601 timestamps (UTC recommended)

Retention limits are enforced server-side; requesting older dates will be clamped to your plan’s window.

Endpoints

All collection endpoints are paginated and accept per_page + page.

GET
/api/v1/instances
Instances you can access
Filters: q · Order: order_by=name|created_at
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/instances?per_page=50&page=1&q=chernarus&order_by=name&order_dir=asc"
GET
/api/v1/log-files
Log files you can access
Filters: q, processed, source_type, instance_sid · Order: order_by=created_at|original_filename|file_size|is_processed
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/log-files?processed=1&per_page=50&page=1&order_by=created_at&order_dir=desc"
GET
/api/v1/instances/{sid}/players
Players for an instance
Filters: q, steam_id · Order: order_by=name|steam_id
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/instances/INSTANCE_SID/players?per_page=50&page=1&q=raven&order_by=name&order_dir=asc"
GET
/api/v1/me
Plan + limits 
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/me"
GET
/api/v1/log-files/{sid}/admin-log-events
Events for a single log file
Filters: event, sub_event, player_steam_id, date_from, date_to, include_payload (Platinum only) · Order: order_by=event_timestamp 
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://dzloggy.com/api/v1/log-files/LOG_FILE_SID/admin-log-events?per_page=50&page=1&event=PLAYER_SPAWN&player_steam_id=7656...&date_from=2025-12-01T00:00:00Z&date_to=2025-12-26T23:59:59Z&order_by=event_timestamp&order_dir=desc"
GET
/api/v1/instances/{sid}/admin-log-events
Events across an instance
Filters: log_file_sid, event, sub_event, player_steam_id, date_from, date_to · Order: order_by=event_timestamp 
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/instances/INSTANCE_SID/admin-log-events?per_page=50&page=1&log_file_sid=LOG_FILE_SID&event=PLAYER_SPAWN"
GET
/api/v1/players/{steam_id}
Player details
Required query param: instance_sid (used to authorize access) 
curl -H "X-API-Key: YOUR_API_KEY" "https://dzloggy.com/api/v1/players/7656...?instance_sid=INSTANCE_SID"