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

# List the events the daily run detected

> Lists the alert events the pipeline recorded for the workspace in the last 30 days, newest first, whether or not any webhook or email alert is subscribed. Each item carries the event, the time it was recorded, the app, the market, one plain sentence and the typed payload. review.new and digest.weekly are never listed, and a drop or exit repeated for subscribers that wait for confirmation is listed once. type takes one or more feed events, comma separated or repeated. appId includes the app's competitors and the search result entrants of the keywords it tracks. since is an ISO 8601 date or instant and is exclusive. Page with nextCursor, which is null on the last page. Answers 400 for an unknown type, a bad since, cursor or limit, and 404 for an app that is not in the workspace.



## OpenAPI

````yaml /api-reference/openapi.json get /alerts/events
openapi: 3.0.0
info:
  title: asobeast API
  description: >-
    Self hosted ASO toolkit API.


    A metered instance carries RateLimit-Limit, RateLimit-Remaining and
    RateLimit-Reset on every response, for the tightest limit the request
    touched. A self hosted instance has no request rate limits and sends no such
    header. Limits are per workspace, so minting more tokens does not buy more
    capacity, and they are sized per plan across three classes: read for stored
    data, write for configuration changes and store for the endpoints that reach
    the App Store or Google Play.


    A 429 carries Retry-After and a rateLimit object naming the window that
    closed, or an aiAllowance object when the workspace has spent the AI calls
    its plan includes this month. A 403 with a quota object means a plan
    capacity limit such as apps or tracked keyword markets, which is a different
    problem from a rate limit. A 402 with an entitlement object means the
    workspace needs a plan.


    Positions are 1-based and null means checked but not found within the
    captured depth, never zero. Daily granularity uses UTC dates.
  version: 1.15.0
  contact: {}
servers:
  - url: http://localhost:3000/api/backend
    description: Web origin proxy
  - url: http://localhost:4000
    description: Direct API
security:
  - personalApiToken: []
tags: []
paths:
  /alerts/events:
    get:
      tags:
        - alerts
      summary: List the events the daily run detected
      description: >-
        Lists the alert events the pipeline recorded for the workspace in the
        last 30 days, newest first, whether or not any webhook or email alert is
        subscribed. Each item carries the event, the time it was recorded, the
        app, the market, one plain sentence and the typed payload. review.new
        and digest.weekly are never listed, and a drop or exit repeated for
        subscribers that wait for confirmation is listed once. type takes one or
        more feed events, comma separated or repeated. appId includes the app's
        competitors and the search result entrants of the keywords it tracks.
        since is an ISO 8601 date or instant and is exclusive. Page with
        nextCursor, which is null on the last page. Answers 400 for an unknown
        type, a bad since, cursor or limit, and 404 for an app that is not in
        the workspace.
      operationId: AlertsController_listEvents
      parameters:
        - name: type
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - metadata.changed
                - rank.dropped
                - rank.improved
                - rank.milestone
                - rank.first
                - rank.overtaken
                - review.negative
                - serp.entrant
                - action.opened
                - chart.entered
                - chart.left
                - chart.milestone
                - rating.dropped
                - review.spike
                - app.delisted
                - app.unlisted_market
        - name: appId
          required: false
          in: query
          schema:
            type: string
            maxLength: 64
        - name: since
          required: false
          in: query
          schema:
            example: '2026-11-01T00:00:00.000Z'
            type: string
        - name: cursor
          required: false
          in: query
          schema:
            maxLength: 200
            type: string
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 50
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    personalApiToken:
      scheme: bearer
      bearerFormat: asob
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.