Monitors

List monitor events

List detected events for a monitor.

GET/v1/monitors/{id}/events
0credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
idstringrequiredpath

Monitor identifier.

min 1 chars

cursorstringoptionalquery

Opaque pagination cursor from a previous response's `nextCursor`.

min 1 chars

limitintegeroptionalquery

Maximum number of events to return. Defaults to 25 server-side.

≥ 1 · ≤ 100

Response fields
13

Endpoint-specific response payload.

Events for this monitor, newest first.

dataevents[]id
string

Stable identifier for the event.

min 1 chars

dataevents[]type
string

Event type, for example `monitor.new_items`.

min 1 chars

dataevents[]payload
object

The event envelope payload delivered to webhooks.

dataevents[]creditsCharged
integer

Credits charged for the check that produced this event.

≥ 0

dataevents[]createdAt
string

ISO-8601 timestamp for when the event was recorded.

datanextCursor
stringnullable

Cursor to pass as `cursor` in the next request when more events are available; otherwise null.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/monitors/abc123/events" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Events recorded for this monitor.