List events Beta

Your project's request log, newest first

Beta. This endpoint is live for design partners, with keys that Dopl issues while the developer portal is being built.

GET /v1/events

Every call your keys make is one event, and its event_id equals the call's Request-Id header. This route reads the calls of the key's own project and environment. Reading the log is not itself logged. Secret key, scope analytics:read. Limited to 60 requests a minute per key.

Authorizations

Authorizationrequiredheaderstring

A project secret key (sk_test_… or sk_live_…) sent as Authorization: Bearer <key>. Server to server only.

Query parameters

cursorquerystring

Opaque. The next_cursor of the previous page, passed back unchanged.

limitqueryinteger

1 to 100. Default 50.

sincequerystring

ISO date and time of the oldest event. Default 24 hours ago, at most 30 days ago.

outcomequery"ok" | "error" | "denied"

Only calls with this outcome.

device_kindquerystring

Only calls that reached this kind of device.

capabilityquerystring

Only calls for this capability, for example present.display.

intentquery"message" | "ask" | "notify" | "display"

Only calls with this intent.

routequerystring

The routing target the call asked for: auto, a device kind or a device ID.

StatusBody
200EventListResponse
400, 401, 403, 429Error