User Profiles - Timeline Graph

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?method=user_details&calculate=graph

Overview

Returns user activity timeline graph data.

Authentication

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

Permissions

• User Profiles: Read permission.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or auth_token)	API key authentication
auth_token	String	Yes (or api_key)	Auth token authentication
app_id	String	Yes	App ID
method	String	Yes	Must be user_details
calculate	String	Yes	Must be graph
uid	String	No	User ID
did	String	No	Device ID alternative
period	String	No	Requested period
bucket	String	No	daily, weekly, monthly, hourly
dbOverride	String	No	Query adapter override
comparisonMode	Boolean/String	No	Comparison mode flag

Examples

/o?api_key=YOUR_API_KEY&app_id=YOUR_APP_ID&method=user_details&calculate=graph&uid=u_102&period=30days&bucket=daily

Response

Success Response

{
  "totals": {
    "s": 12,
    "e": 54,
    "d": 9,
    "ds": 3,
    "tsd": 4210
  },
  "graph": {
    "2026:2:14": { "s": 2, "e": 8 },
    "2026:2:15": { "s": 1, "e": 5 }
  }
}

Response Fields

Field	Type	Description
totals	Object	Aggregated user totals in selected period
graph	Object	Bucketed timeline points

Error Responses

• HTTP 400 - Query execution issue:

{
  "result": "Error. Please check logs."
}

Behavior

• Resolves uid from did when needed.
• Maps bucket aliases (daily, weekly, monthly, hourly) to internal bucket keys.
• Returns {} when user cannot be resolved.

Related Endpoints

• User Profiles - Sessions
• User Profiles - Events Table

Implementation details

Configuration Impact

Setting	Default	Affects	User-visible impact
users.*	User profile feature defaults	User-details retrieval behavior in profile endpoints.	Changes to user feature settings can affect which profile-related fields/aggregations are returned.

Database Collections

Collection	Used for	Data touched by this endpoint
countly.app_users{appId}	Per-app user profiles	Stores user-level properties and profile fields affected by this endpoint.
countly_drill.drill_events	Drill event records	Stores granular event rows queried or updated by this endpoint.