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 `data.page.nextCursor` (or legacy `data.nextCursor`).

min 1 chars

limitintegeroptionalquery

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

≥ 1 · ≤ 100

Response fields
15

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.

Pagination state for the current page of events.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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.