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

# List analytics event names

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the names of the analytics events the app has tracked, most frequent first, with how many times each one was recorded.

Use this to discover what an app tracks before you query it. Pass a `name` from the response as the `event_name` to [Query analytics events](/api-reference/query-analytics-events), [Aggregate analytics events over time](/api-reference/aggregate-analytics-events-over-time), or [List analytics event properties](/api-reference/list-analytics-event-properties).

Base44 keeps analytics events for 60 days, so counts cover the last 60 days and an event the app stopped sending before that no longer appears. The response returns at most the 1000 most frequent names.

<Note>Events are written asynchronously, so an event the app tracked in the last few seconds can be missing from the response.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/analytics/names
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/analytics/names:
    get:
      summary: List analytics event names
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns the names of the analytics events the app has tracked, most
        frequent first, with how many times each one was recorded.


        Use this to discover what an app tracks before you query it. Pass a
        `name` from the response as the `event_name` to [Query analytics
        events](/api-reference/query-analytics-events), [Aggregate analytics
        events over time](/api-reference/aggregate-analytics-events-over-time),
        or [List analytics event
        properties](/api-reference/list-analytics-event-properties).


        Base44 keeps analytics events for 60 days, so counts cover the last 60
        days and an event the app stopped sending before that no longer appears.
        The response returns at most the 1000 most frequent names.


        <Note>Events are written asynchronously, so an event the app tracked in
        the last few seconds can be missing from the response.</Note>
      operationId: get_event_names_api_apps__app_id__analytics_names_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose analytics to read.
            title: App Id
          description: ID of the app whose analytics to read.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventNamesResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You don't have editor access to this app.
        '404':
          description: App not found.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - read_only
        - WorkspaceApiKeyAuth:
            - read_only
        - WorkspaceApiKeyBearerAuth:
            - read_only
components:
  schemas:
    EventNamesResponse:
      properties:
        event_names:
          items:
            $ref: '#/components/schemas/EventNameInfo'
          type: array
          title: Event Names
          description: The app's event names, most frequent first.
          example:
            - count: 15320
              name: page_view
            - count: 1842
              name: checkout_completed
      type: object
      title: EventNamesResponse
      description: The analytics event names an app has recorded.
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    EventNameInfo:
      properties:
        name:
          type: string
          title: Name
          description: Name of the event, as the app tracked it.
          example: checkout_completed
        count:
          type: integer
          title: Count
          description: Number of times the event was recorded across the retained history.
          example: 1842
      type: object
      required:
        - name
        - count
      title: EventNameInfo
      description: Information about a tracked event name.
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

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