> ## 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:
  - ApiKeyAuth: []
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: The app's tracked event names.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventNamesResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You don't have access to this app.
        '404':
          description: App not found.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
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: Response for event names discovery.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````