---
title: "Event Properties"
method: GET
path: "/v2/campaigns/event-properties"
tags: ["Campaigns V2"]
---

# Event Properties

`GET /v2/campaigns/event-properties`

Returns the distinct property keys seen for the given event names in an application — each with an inferred value type and up to 25 recent example values — from the ClickHouse `event_attributes` table. Powers the campaign rule editor's LHS property picker (user / device / placement-parameter options plus RHS value suggestions). Requires campaigns:read scope.

## Query parameters

- `application_id` string, required — Application ID (required)
- `names` union, required — Event names to fetch properties for (comma-joined string or repeated param)
  - string
  - string[]

## Response `200`

Event properties list

- object — Event properties list
  - `object` 'list', required — Object type, always `list`
  - `data` object[], required — Event property rows
    - `name` string, required — Event name the key was seen on (e.g. `user_attributes`, `device_attributes`, or a placement event name)
    - `key` string, required — The property key
    - `type` string, required — Inferred value type of the property (raw ClickHouse type)
    - `recent_values` string[], required — Up to 25 recent distinct example values (used as RHS suggestions)
    - `last_inserted_at` string, required — When the property was most recently seen

## Other responses

- `400` — The request did not match the expected schema
- `401` — No API key was provided in the request
- `403` — The API key does not have permission to perform this action
- `404` — The requested resource was not found
- `429` — Too many requests have been made in a short period
- `500` — An unexpected error occurred on the server

---

[API](https://skmtc.dev/superwall/apis/superwall-api-v2.md) · [All operations](https://skmtc.dev/superwall/apis/superwall-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superwall/superwall-api-v2/revisions/e04f76c478af/schema)