Connecting your SIEM
This article is for the person configuring your SIEM tool. Before you start, make sure the SIEM add-on is active and you've created an API key (see Creating and managing your SIEM API keys).
The feed endpoint
Go to Settings > SIEM. Under SIEM status you'll find the endpoint to poll, alongside a Copy button. Configure your SIEM to poll this endpoint. Events are returned in OCSF version 1.6.0 JSON.
Authentication
Each request must include an Authorization header built from your API key's ID and secret:
Authorization: SIEM <key-id>:<secret>
Requests are scoped to the company the key belongs to, so a key only ever returns your own company's events.
Collecting events incrementally
The feed is time-ordered and paginated. You can narrow and page through results with these query parameters:
since: return events from this time onwards (ISO 8601, inclusive).until: return events up to this time (ISO 8601, exclusive).limit: number of events per page (default 500, maximum 1000).cursor: the pagination cursor returned with each page.
A typical setup polls on a fixed schedule, pages through all results using cursor, then advances since to the time of the last event collected so each poll only fetches what's new.
Rate limits
The feed applies a per-company rate limit. Polling on a sensible interval (rather than continuously) keeps you comfortably within it.
