License - MAU 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/mau

Overview

Returns monthly active users (MAU) summed over all apps, for each month of the selected period. This is the usage measure used by MAU-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 MAU for the last 12 months

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

Read MAU for a date range

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

Response

Success Response

{
  "2025:1": 1250,
  "2025:2": 1310,
  "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 active users 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.

Related Endpoints

• License - Data Point 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.users	Active user counts	Reads the monthly user totals of every app.