---
title: "List structured app events"
method: GET
path: "/app-events"
tags: ["App Events"]
---

# List structured app events

`GET /app-events`

Structured, app-scoped events (e.g. app.whatsapp.message_received) derived from raw device notifications. Typed columns — not raw payloads (those stay in the event log).

## Query parameters

- `page` integer
- `pageSize` integer
- `eventType` string
- `source` 'app' | 'system' | 'device' | 'webhook'
- `deviceId` string, uuid
- `from` string, nullable
- `to` string, nullable

## Response `200`

App event history

- object
  - `items` Event[], required
    - `id` string, uuid, required
    - `userId` string, uuid, required — Deprecated: use ownerId (tenancy) / createdBy (actor).
    - `ownerId` string, uuid, required
    - `createdBy` string, uuid, nullable, required
    - `deviceId` string, uuid, nullable, required
    - `rawEventId` string, uuid, nullable, required
    - `eventType` string, required
    - `source` 'app' | 'system' | 'device' | 'webhook', required
    - `payload` object, required
    - `occurredAt` string, nullable, required
    - `createdAt` string, nullable, required
  - `pagination` Pagination, required
    - `hasNext` boolean, required
    - `hasPrev` boolean, required
    - `page` integer, required
    - `pageSize` integer, required
    - `pages` integer, required
    - `total` integer, required

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/versions/1bc499aa8f99/schema)