Event data

Get an event's custom properties

GET/api/websites/{websiteId}/event-data/{eventId}

Returns the custom property records, data types, and values attached to a specific event.

Try it

Headers

Name	Type	Description
Authorizationrequired	string	Token returned by POST /api/auth/login, or an API key (`umami_…`) created under Settings → API keys (self-hosted only). `Bearer <token>`.
x-umami-share-contextrequired	string	Required context header when authenticating with a share token. `<api-key>`.
x-umami-share-tokenrequired	string	Signed token returned by a share endpoint. `<api-key>`.

Path parameters

Name	Type	Description
websiteIdrequired	string	ID of the website.
eventIdrequired	string	ID of the event.

Responses

200The operation completed successfully.

Name	Type	Description
createdAtrequired	string	Date and time the record was created.
dataKeyrequired	string	Name of the custom property.
dataTyperequired	number	Data type of the custom property.
dateValuerequired	string	Custom property value stored as a date-time.
idrequired	string	Unique identifier of the resource.
numberValuerequired	object	Custom property value stored as a number.

stringValuerequired	string	Custom property value stored as a string.
websiteEventIdrequired	string	ID of the website event.
websiteIdrequired	string	ID of the website.

200 example

[
  {
    "createdAt": "2024-01-15T09:30:00Z",
    "dataKey": "string",
    "dataType": 0,
    "dateValue": "2024-01-15T09:30:00Z",
    "id": "string",
    "numberValue": {
      "d": [
        0
      ],
      "e": 0,
      "s": 0
    },
    "stringValue": "string",
    "websiteEventId": "string",
    "websiteId": "string"
  }
]

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

Code samples

cURL

curl -X GET 'https://api.example.com/api/websites/{websiteId}/event-data/{eventId}' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-umami-share-context: <api-key>' \
  -H 'x-umami-share-token: <api-key>'

PreviousGet event property values over time NextSummarize properties by event