Events

Retrieve processed events for server-side fraud/risk decisions.

Get processed event by id

get

https://api.guardianstack.aihttp://localhost:3000

/request/event/{id}

Returns a processed view of an event for fraud / risk evaluation.

Authentication

• Preferred: Authorization: Bearer <secret>

• Alternative (legacy): ?secret=<secret> query parameter

Event availability / eventual consistency Events are processed asynchronously; the event may temporarily return 404 shortly after creation. The official Server SDK retries 404 for a short time window.

Authorizations

bearerAuthsecretQuery

AuthorizationstringRequired

Use your Guardian secret key as a Bearer token.

Example: Authorization: Bearer sec_xxx

Path parameters

idstringRequired

Guardian event identifier (e.g. evt_123).

Responses

200

Processed event payload

application/json

400

Bad request

application/json

401

Unauthorized (missing or invalid secret key)

application/json

402

Payment required (free quota exceeded)

application/json

403

Forbidden (event does not belong to the key)

application/json

404

Event not found (may occur while the event is still processing)

application/json

500

Unexpected server error

application/json

get

/request/event/{id}

curlNode.js

curl -sS \
  -H "Authorization: Bearer sec_xxx" \
  "https://api.guardianstack.ai/request/event/evt_123"

{
  "identification": {
    "id": "evt_123",
    "visitorId": "vis_abc",
    "ip": "203.0.113.10",
    "timestamp": "2025-01-01T12:00:00.000Z",
    "url": "https://example.com/checkout",
    "location": {
      "country": "Italy",
      "country_code": "IT",
      "city": "Milan",
      "timezone": "Europe/Rome",
      "is_eu_member": true
    },
    "browser": {
      "browserName": "Chrome",
      "browserMajorVersion": "131",
      "browserFullVersion": "131.0.6778.0",
      "platform": "mac",
      "os": "Mac OS",
      "osVersion": "14.6",
      "device": "Desktop",
      "userAgent": "Mozilla/5.0 ..."
    }
  },
  "vpn": {
    "detected": false,
    "ipTimezone": "Europe/Rome"
  },
  "botDetection": {
    "detected": false,
    "score": 12,
    "automationSignalsPresent": false,
    "indicators": []
  },
  "velocity": {
    "5m": 1,
    "1h": 3,
    "24h": 12
  },
  "visitorVelocity": {
    "5m": 1,
    "1h": 3,
    "24h": 12,
    "7d": 80
  }
}