events

List simulation events

The interaction log: one row each time a simulation was sent, opened, clicked, scanned by a gateway, had credentials submitted to it, or was reported. Each row names the person it belongs to. IP addresses and user agents are stored but never returned.

get/events

Request

  • Base URL: https://api.fallax.io/v1
  • URL: https://api.fallax.io/v1/events
  • Auth: HTTP bearer

Query parameters

limitstring

Rows per page, 1 to 200. Defaults to 50. A page comes back with a nextCursor when there are more.

Example:50
cursorstring

The nextCursor from the previous page. Paging is by cursor rather than by offset, so rows written while you page are never skipped.

sincestring

Only rows after this instant, exclusive. ISO 8601 or epoch milliseconds. This is the parameter a poll trigger uses: pass the timestamp of the newest row you have already handled.

Example:2026-09-07T12:00:00Z
order'desc' | 'asc'

desc (the default) for newest first, which is what a person reading a page wants. asc for oldest first, which is what anything resuming from a watermark wants: with since and a limit, an ascending page is the oldest rows you have not seen, so a backlog drains in order instead of the newest page hiding the rest.

typestring

Comma-separated: sent, opened, clicked, scanned, submitted, reported. Omit for all of them.

Example:sent,opened
campaignIdstring

Only events from one campaign.

Response

List simulation events

nextCursorstring nullable required

Pass as cursor for the next page.

hasMoreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.