> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobilerun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List structured 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).



## OpenAPI

````yaml /api-reference/workflows.yaml get /app-events
openapi: 3.1.0
info:
  title: Workflows
  version: v1
servers:
  - url: https://api.mobilerun.ai
    description: Droidrun Cloud API
security:
  - bearerAuth: []
paths:
  /app-events:
    get:
      tags:
        - App Events
      summary: List structured app events
      description: >-
        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).
      operationId: listAppEvents
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            default: 1
          required: false
          name: page
          in: query
        - schema:
            type: integer
            exclusiveMinimum: 0
            default: 10
          required: false
          name: pageSize
          in: query
        - schema:
            type: string
            maxLength: 128
          required: false
          name: eventType
          in: query
        - schema:
            type: string
            enum:
              - app
              - system
              - device
              - webhook
          required: false
          name: source
          in: query
        - schema:
            type: string
            format: uuid
          required: false
          name: deviceId
          in: query
        - schema:
            type:
              - string
              - 'null'
          required: false
          name: from
          in: query
        - schema:
            type:
              - string
              - 'null'
          required: false
          name: to
          in: query
      responses:
        '200':
          description: App event history
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Event'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - items
                  - pagination
components:
  schemas:
    Event:
      type: object
      properties:
        id:
          type: string
          format: uuid
        userId:
          type: string
          format: uuid
        deviceId:
          type:
            - string
            - 'null'
          format: uuid
        rawEventId:
          type:
            - string
            - 'null'
          format: uuid
        eventType:
          type: string
        source:
          type: string
          enum:
            - app
            - system
            - device
            - webhook
        payload:
          type: object
          additionalProperties: {}
        occurredAt:
          type:
            - string
            - 'null'
        createdAt:
          type:
            - string
            - 'null'
      required:
        - id
        - userId
        - deviceId
        - rawEventId
        - eventType
        - source
        - payload
        - occurredAt
        - createdAt
    Pagination:
      type: object
      properties:
        hasNext:
          type: boolean
        hasPrev:
          type: boolean
        page:
          type: integer
          minimum: 1
        pageSize:
          type: integer
          minimum: 1
        pages:
          type: integer
          minimum: 0
        total:
          type: integer
          minimum: 0
      required:
        - hasNext
        - hasPrev
        - page
        - pageSize
        - pages
        - total
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Opaque
      description: Bearer token via Authorization header

````