Skip to main content
POST
Query log events
Requires logs:read, an eligible customer subscription and access to the connected server’s Logs source.
string
cfx.re join code. Required for a global key; optional for a server-bound key. A key bound to another server is refused.
string
required
RFC 3339 start time.
string
required
RFC 3339 end time. The range may span at most seven days and is limited by plan retention.
integer
default:"100"
1 to 100 results. Defaults to 100.

Filters

string
Optional debug, info, warn, error or fatal filter.
string
Optional event type.
string
Optional resource name.
string
Optional message search.
string
Optional player handle.
object
Exact match such as {"owner":"player","key":"discord","value":"123"}. Owner can be player or target.
string
Optional opaque pagination.nextCursor from the previous response.
Set LOGS_FROM and LOGS_TO to the UTC timestamps you want to search:
This example uses a server-bound key. Include serverId when using a global key.

Response and pagination

Events use snake_case fields such as event_id, occurred_at, event_type and player_identifiers. When hasMore is true, keep the original request’s from, to, server and filters unchanged and send nextCursor as cursor. The returned range describes the effective search window after retention is applied; it may be narrower than the original request. Start a new search when the cursor expires or the filters change. Responses are private and not cached. Rate limits and concurrent-search limits apply; honor Retry-After on RATE_LIMITED responses.