Overview

The Activity API exposes a unified audit log for every customer-scoped action (zones, records, billing, alerts, and more). Use it to power compliance exports, investigate configuration drift, or display recent activity inside custom tooling.

Required scope: activity:read

Endpoint

Method	Endpoint	Description
`GET`	`/v1/activity`	List activity log entries for the authenticated customer

List Activity Logs

curl "https://api.dnscale.eu/v1/activity?resource=zone&action=update&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Default	Description
`limit`	integer	50	Number of items to return (max 100)
`offset`	integer	0	Number of items to skip for pagination
`resource`	string	—	Filter by resource type (`zone`, `record`, `user`, etc.)
`action`	string	—	Filter by verb (`create`, `update`, `delete`, etc.)
`search`	string	—	Case-insensitive search across action, resource, resource ID, and payload
`start_time`	RFC3339 timestamp	—	Only return entries at or after this time
`end_time`	RFC3339 timestamp	—	Only return entries at or before this time

Response

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "9f5d1a0c-1df1-4ff6-b264-eb5bde7822f1",
        "action": "update",
        "resource": "zone",
        "resource_id": "zone_123",
        "old_values": {"status": "pending"},
        "new_values": {"status": "active"},
        "ip_address": "203.0.113.10",
        "user_agent": "dnscale-dashboard/1.8.2",
        "user_email": "sre@example.com",
        "user_name": "Alex Admin",
        "created_at": "2025-11-05T14:22:18Z"
      }
    ],
    "meta": {
      "limit": 20,
      "offset": 0
    }
  }
}

Filtering Tips

Combine resource + action for precise queries (e.g., resource=record&action=delete).
Use search to quickly find activity for a specific zone name or ID.
Pair start_time and end_time to export a time-bounded subset for compliance reviews.
Paginate with limit/offset to stream results into SIEM tooling.