License - Data Point Metrics

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/license-metrics/dp

Overview

Returns the number of data points (DP) received, summed over all apps, for each month of the selected period. This is the usage measure used by data-point-based licenses.

Authentication

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

Permissions

Requires Read permission on the drill feature.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.
app_id	String	Conditional	Required for users who are not global admins.
period	String	No	Period to report, for example 30days or a JSON range [start,end] in milliseconds. Defaults to the last 12 months.

Examples

Read data points for the last 12 months

/o/license-metrics/dp?api_key=YOUR_API_KEY

Read data points for a date range

/o/license-metrics/dp?api_key=YOUR_API_KEY&period=[1735689600000,1767225600000]

Response

Success Response

{
  "2025:1": 4800000,
  "2025:2": 5100000,
  "2025:3": 0
}

Response Fields

The response is an object with one key for each month of the period, in the form YEAR:MONTH. The value is the number of data points in that month, summed over all apps. Months with no data are 0.

Error Responses

• 500

{
  "result": "Error in reading license"
}

Behavior

• Read-only for the metric itself.
• Returns an empty object {} when the server is a Countly Flex deployment.
• Returns 0 for every month when server statistics are not available.

Related Endpoints

• License - MAU Metrics
• License - History

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.members	Authentication and permission check	Reads the member and permissions.
countly.plugins	License	Reads the installed license.
countly.server_stats_data_points	Data point counts	Reads monthly data point totals.