Read extended event metadata

Ⓔ Enterprise Only
This API is available exclusively in Countly Enterprise.

Endpoint

/o/data-manager/events-extended

Overview

Returns merged event metadata from event map and drill metadata, including latest audit information.

Authentication

Countly API supports three authentication methods:

1. API key query parameter: api_key=YOUR_API_KEY
2. Auth token query parameter: auth_token=YOUR_AUTH_TOKEN
3. Auth token header: countly-token: YOUR_AUTH_TOKEN

Permissions

Requires data_manager Read permission.

Request Parameters

Parameter	Type	Required	Description
app_id	String	Yes	Target app ID.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Response

Success Response

[
  {
    "key": "purchase",
    "name": "Purchase",
    "description": "Purchase event",
    "status": "live",
    "is_visible": true,
    "segments": ["country", "price"],
    "audit": {
      "userName": "Jane Doe",
      "ts": 1739599800
    }
  }
]

Response Fields

Field	Type	Description
[]	Array	List of merged event metadata objects.
[].audit	Object	Latest matching audit object (if available).

Error Responses

• 500

{
  "result": "Error"
}

Behavior/Processing

• Reads event list/map from countly.events.
• Reads event metadata from countly_drill.drill_meta (excluding internal/cohort/biglist).
• Reads latest relevant event logs from countly.systemlogs and member names from countly.members.
• Merges data by event key and returns combined array.

Audit & System Logs

• This endpoint does not emit /systemlogs actions.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.events	Base event catalog	Reads event list, map, and segments metadata.
countly_drill.drill_meta	Drill-level event metadata	Reads event status and segment model metadata for merge with base event catalog.
countly.systemlogs	Audit enrichment source	Reads latest event-related system log entries for each returned event.
countly.members	User-name enrichment source	Resolves user_id from system logs to member full names (audit.userName).

---

Examples

/o/data-manager/events-extended?
  app_id=64f5c0d8f4f7ac0012ab3456

---

Related Endpoints

• Events - Create
• Event Status - Update
• Events Visibility - Update

---

Last Updated

2026-02-16