---
title: "List analytics event properties"
method: GET
path: "/api/apps/{app_id}/analytics/{event_name}/properties"
---

# List analytics event properties

`GET /api/apps/{app_id}/analytics/{event_name}/properties`

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

Returns the property keys the app has sent with a given event, so you know what you can filter, aggregate, and group by.

Properties are whatever the app passes to `base44.analytics.track()`, so they differ per event. Get the event names first with [List analytics event names](/api-reference/list-analytics-event-names).

To use a key from the response, prefix it with `properties.`. For example, pass `properties.plan` as a filter field in [Query analytics events](/api-reference/query-analytics-events), or as a metric `field` in [Aggregate analytics events by field](/api-reference/aggregate-analytics-events-by-field).

<Warning>Only a key made up of letters, digits, and underscores, starting with a letter or an underscore, can be used that way. An app can track a property whose key holds a space, a hyphen, or a leading digit, and this endpoint returns it, but you cannot filter or aggregate on it. Rename such a property in the app to query it.</Warning>

Keys come from the events retained over the last 60 days. The response returns at most 100 keys and does not say whether it truncated, so an event that carries more than 100 distinct keys reports only some of them.

## Path parameters

- `event_name` string, required — Name of the event whose property keys to return, exactly as the app tracked it. An event the app never tracked returns an empty list.
- `app_id` string, required — ID of the app whose analytics to read.

## Response `200`

The event's property keys.

- EventPropertyKeysResponse — Response for event property keys discovery.
  - `event_name` string, required — Name of the event the property keys belong to.
  - `property_keys` string[] — Property keys the app has sent with this event. Prefix a key with `properties.` to filter, aggregate, or group by it, which works for keys made up of letters, digits, and underscores.

## Other responses

- `401` — Missing or invalid credentials.
- `403` — You don't have access to this app.
- `404` — App not found.
- `422` — Validation Error

## Changes

- **2026-08-25** `8dfd9c46c0b9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/apps/:app_id/analytics/:event_name/properties/get.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idealspot/base44-app-management-api/revisions/31ef75eb64ab/schema)