Skip to main content

Journey Engine - Stats Performance

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/o/journey-engine/stats/performance

Overview

Return performance metrics over time (users entered, completed, engaged, drop-off).

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

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 filter. Use "0days" for yearly aggregation

Examples

GET /o/journey-engine/stats/performance?journeyDefinitionId=67164f4a1f1bd90d6354430a&period=30days

Response

Success Response

{
"2024.01.01": {"usersEntered": 10, "usersCompleted": 2, "usersEngaged": 6, "usersDropOff": 1},
"2024.01.02": {"usersEntered": 14, "usersCompleted": 3, "usersEngaged": 7, "usersDropOff": 2}
}

Response Fields

FieldTypeDescription
(root object)ObjectDate/year keyed metric map.
<date>.usersEnteredNumberUsers entered count for this bucket.
<date>.usersCompletedNumberUsers completed count for this bucket.
<date>.usersEngagedNumberUsers engaged count for this bucket.
<date>.usersDropOffNumberUsers drop-off count for this bucket.

Error Responses

  • 500: Query error

Behavior

  • Filters journey_stats by journeyVersionId and/or journeyDefinitionId when provided.
  • With period=0days, groups by year and returns year keys.
  • With any other period, uses the current period date array, groups by YYYY.MM.DD, and fills missing dates with zero-value metric objects.
  • Sorts buckets chronologically.
  • No related endpoints
Implementation details

Database Collections

CollectionUsed forData touched by this endpoint
countly.journey_statsEndpoint data sourceStores endpoint-related records this endpoint reads or modifies.