Sign in

List analytics event 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.

To use a key from the response, prefix it with properties.. For example, pass properties.plan as a filter field in Query analytics events, or as a metric field in 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.

get/api/apps/{app_id}/analytics/{event_name}/properties

Path parameters

event_namestring 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.

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_idstring required

ID of the app whose analytics to read.

ID of the app whose analytics to read.

Response

The event's property keys.

event_namestring required

Name of the event the property keys belong to.

property_keysstring[]

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.

Example response

{
  "event_name": "checkout_completed",
  "property_keys": [
    "plan",
    "amount",
    "currency"
  ]
}

Changes