Journey Engine - Stats Active Users

Endpoint

/o/journey-engine/stats/active-users

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

Overview

Return active user counts for journeys with comparison to previous period.

Authentication

• Authentication methods:
  • API Key (parameter): api_key=YOUR_API_KEY
  • Auth Token (parameter): auth_token=YOUR_AUTH_TOKEN
  • Auth Token (header): countly-token: YOUR_AUTH_TOKEN

Permissions

• Required permission: Read on the journey_engine feature

Request Parameters

• journeyVersionId (optional): Filter by journey version
• journeyDefinitionId (optional): Filter by journey definition
• period (optional): Time period for comparison (defaults to hourly)

Response

Success Response

{
  "activeUsers": 120,
  "previousActiveUsers": 110,
  "change": 9.09
}

Response Fields

Field	Type	Description
activeUsers	Number	Current period active-user count. The implementation sums users_completed.
previousActiveUsers	Number	Previous period active-user count.
change	Number or String	Percentage change from previous period, or "-" when previous count is zero.

Error Responses

• 500: Query error

Examples

GET /o/journey-engine/stats/active-users?journeyDefinitionId=67164f4a1f1bd90d6354430a&period=7days

Behavior/Processing

• Filters journey_stats by journeyVersionId and/or journeyDefinitionId when provided.
• Uses Countly period helpers when period is provided; otherwise defaults to the helper's hourly/current behavior.
• Calculates active users by summing users_completed for current and previous period arrays.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.journey_stats	Endpoint data source	Stores endpoint-related records this endpoint reads or modifies.

Related Endpoints

• No related endpoints

Ⓔ Enterprise

This feature is part of Countly Enterprise.

Get Access:

• Learn about Enterprise
• Contact Sales
• Compare Versions

Already a Customer? Use support portal if you have any questions

---

Last Updated

2026-04-18