Get Event | OnyxMetric

Reads the server-side enrichment of one tracked event by its event_id, within milliseconds of tracking.

GET /api/sites/:site/events/:eventId

Returns what OnyxMetric derived on the server for a single event (browser, operating system, device type, location, network) without waiting for the event to be queryable in analytics. The eventId is the event_id returned by Send Events.

Enrichment is kept for 10 minutes after the event is tracked, and only for events sent with an API key that has the ingest:write permission. Reading requires the events:read permission. For older events use Get Events.

Path Parameters

Prop

Type

Response

The body is a flat object. Field names match the events table columns.

Prop

Type

The response carries a Server-Timing: redis;dur=<ms> header with the lookup time.

Errors

Status	Meaning
`400`	`eventId` is not a UUID
`404`	No enrichment stored: unknown id, older than 10 minutes, or the event was not sent with a trusted API key

Request

curl -X GET "https://app.onyxmetric.com/api/sites/1/events/0b6f3a52-6f0f-4f6e-9a39-6f2f2d6f1c11" \
  -H "Authorization: Bearer $ONYX_API_KEY"

Request

const response = await fetch(
  'https://app.onyxmetric.com/api/sites/1/events/0b6f3a52-6f0f-4f6e-9a39-6f2f2d6f1c11',
  { headers: { 'Authorization': 'Bearer your_api_key_here' } }
);
const data = await response.json();

Request

import requests

response = requests.get(
    "https://app.onyxmetric.com/api/sites/1/events/0b6f3a52-6f0f-4f6e-9a39-6f2f2d6f1c11",
    headers={"Authorization": "Bearer your_api_key_here"},
)
data = response.json()

Response

{
  "timestamp": "2026-10-15T12:00:00.000Z",
  "browser": "Safari",
  "browser_version": "18",
  "operating_system": "iOS",
  "operating_system_version": "18.5",
  "device_type": "Mobile",
  "country": "US",
  "region": "US-NY",
  "city": "New York",
  "timezone": "America/New_York",
  "language": "en-US",
  "screen_width": 393,
  "screen_height": 852,
  "asn": 21928,
  "asn_org": "T-MOBILE-AS21928",
  "is_datacenter_asn": 0,
  "props": {},
  "user_event_count": 1
}