Get and filter logs of API calls and events

Access a detailed log of all API calls and system events performed on your account. Use it to troubleshoot problems, review security activity, or track specific actions taken within your account.

Domain Services Domains

Context

Used in the dashboard

/audit-log

Query Parameters

end_date string required · Example: 2026-02-10T00:00:00.000Z
hide_get string · Example: true
include_stats string · enum required · Example: true
false
true
limit string required · Example: 50
page string required · Example: 0
start_date string required · Example: 2026-02-10T00:00:00.000Z

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.hasMore boolean required · Example: false
data.limit integer required · Example: 50
data.logs array<object> required · Example: [{"id":"0937fc15-be3a-47e6-9302-98ad5700aba7","timestamp":"2026-02-10T00:00:00.000Z","m...
data.logs[].auth_method string required · Example: session
data.logs[].client_id string required · Example: 30000
data.logs[].duration_ms integer required · Example: 11
data.logs[].endpoint string required · Example: /api/billing/invoices
data.logs[].error_message string · nullable required · Example: Bandwidth limit reached for this VM. Reinstall/Rebuild is blocked until usage resets or...

Nullable: may be null when not applicable.

data.logs[].id string required · Example: 0937fc15-be3a-47e6-9302-98ad5700aba7
data.logs[].ip_address string required · Example: 192.0.0.1
data.logs[].method string · enum required · Example: POST
DELETE
GET
POST
PUT
data.logs[].path string required · Example: /api/billing/invoices
data.logs[].resources_accessed array<string> required · Example: ["client:11269:invoices"]
data.logs[].severity string · enum required · Example: info
error
info
warning
data.logs[].status_code integer required · Example: 200
data.logs[].success boolean required · Example: true

True for successful responses.

data.logs[].tags array<string> required · Example: ["invoice_viewed"]
data.logs[].timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

data.logs[].user_agent string required · Example: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome...
data.page integer required · Example: 0
data.stats object
data.stats.apiCalls integer required · Example: 1087
data.stats.avgResponseTime integer required · Example: 299
data.stats.failedLogins integer required · Example: 0
data.stats.loginCount integer required · Example: 0
data.stats.recentActivity array<object> required · Example: [{"date":"2026-02-10T00:00:00.000Z","count":496},{"date":"2026-02-10T00:00:00.000Z","co...
data.stats.recentActivity[].count integer required · Example: 496
data.stats.recentActivity[].date string required · Example: 2026-02-10T00:00:00.000Z
data.stats.securityEvents integer required · Example: 0
data.stats.topEndpoints array<object> required · Example: [{"endpoint":"/api/vm/10000/active-jobs","count":144},{"endpoint":"/api/vm/10000/rebuil...
data.stats.topEndpoints[].count integer required · Example: 144
data.stats.topEndpoints[].endpoint string required · Example: /api/vm/10000/active-jobs
data.stats.totalEvents integer required · Example: 1087
data.total integer required · Example: 15
meta object required
meta.headers object required
meta.headers.X-Cache string required · Example: MISS
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/audit-log
For AI assistants
cURL
curl -X GET "https://cloud.hostup.se/api/audit-log?end_date=2026-02-10T00%3A00%3A00.000Z&include_stats=true&limit=50&page=0&start_date=2026-02-10T00%3A00%3A00.000Z" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "logs": [
      {
        "id": "0937fc15-be3a-47e6-9302-98ad5700aba7",
        "timestamp": "2026-02-10T00:00:00.000Z",
        "method": "POST",
        "endpoint": "/api/billing/invoices",
        "path": "/api/billing/invoices",
        "client_id": "30000",
        "ip_address": "192.0.0.1",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.0.0.1 Safari/537.36",
        "status_code": 200,
        "success": true,
        "duration_ms": 11,
        "error_message": null,
        "auth_method": "session",
        "resources_accessed": [
          "client:11269:invoices"
        ],
        "severity": "info",
        "tags": [
          "invoice_viewed"
        ]
      },
      {
        "id": "8dc18989-d395-47fb-b440-b79730461416",
        "timestamp": "2026-02-10T00:00:00.000Z",
        "method": "POST",
        "endpoint": "/api/billing/invoices",
        "path": "/api/billing/invoices",
        "client_id": "30000",
        "ip_address": "192.0.0.1",
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/192.0.0.1 Safari/537.36",
        "status_code": 200,
        "success": true,
        "duration_ms": 232,
        "error_message": null,
        "auth_method": "session",
        "resources_accessed": [
          "client:11269:invoices"
        ],
        "severity": "info",
        "tags": [
          "invoice_viewed"
        ]
      },
      {
        "_truncated": "... and 13 more items"
      }
    ],
    "total": 15,
    "stats": {
      "totalEvents": 1087,
      "loginCount": 0,
      "failedLogins": 0,
      "apiCalls": 1087,
      "securityEvents": 0,
      "avgResponseTime": 299,
      "topEndpoints": [
        {
          "endpoint": "/api/vm/10000/active-jobs",
          "count": 144
        },
        {
          "endpoint": "/api/vm/10000/rebuild-status",
          "count": 133
        },
        {
          "_truncated": "... and 8 more items"
        }
      ],
      "recentActivity": [
        {
          "date": "2026-02-10T00:00:00.000Z",
          "count": 496
        },
        {
          "date": "2026-02-10T00:00:00.000Z",
          "count": 81
        }
      ]
    },
    "page": 0,
    "limit": 50,
    "hasMore": false
  },
  "meta": {
    "headers": {
      "X-Cache": "MISS"
    }
  }
}