Get Daily Feature Usage
Retrieve daily feature usage summaries by UTC date, product, feature name, event name and license.
Summaries contain events recorded with RegisterEvent or RegisterEvents. Use an access token with Usage Analytics permission.
Parameters
This method is accessed by https://api.cryptolens.io/api/ai/GetDailyFeatureUsage. Both GET and POST are supported.
| Parameter | Description | Remarks |
| Limit | Maximum number of daily summary rows to return. Zero uses the default. | Optional. Default 100; maximum 1000. |
| NewestFirst | Set to true to return the highest matching summary row IDs first, without supplying a cursor. False returns rows in ascending ID order. This is row-creation ID order, not DateUtc or LastUsedUtc order. | Optional boolean. Default false. |
| StartingAfter | Continue from the last returned Id, excluding it. With NewestFirst=false, return higher IDs ascending; with true, return lower IDs descending. Omit on the first page and keep NewestFirst unchanged while paging. | Optional, 64-bit integer. |
| EndingBefore | Return rows whose Id is less than this value, ordered by Id descending. Takes precedence when both cursors are supplied. | Optional, 64-bit integer. |
| ProductId | Filter by product. Required when supplying a license key string. Zero or omission includes all products permitted by the access token. | Conditionally optional. |
| KeyId | Filter by the numeric license key ID. Zero or omission includes all permitted licenses. | Optional, 64-bit integer. |
| Key | Filter by the license key string. Requires ProductId. If KeyId is also supplied, both must identify the same license. | Optional. |
| FeatureName | Match an exact feature name, including capitalization and whitespace. Omitted or empty values include all names, including unnamed features. | Optional, at most 100 characters. |
| EventName | Match an exact event name, including capitalization and whitespace. Omitted or empty values include all names, including unnamed events. | Optional, at most 100 characters. |
| Start | Return daily rows on or after this UTC date (inclusive). | Optional, yyyy-MM-dd. |
| End | Return daily rows on or before this UTC date (inclusive). Must not precede Start. | Optional, yyyy-MM-dd. |
| token | An access token with Usage Analytics permission. | Required. |
| v | Method version. | Optional. Default 1. |
Results
| Parameter | Description | Remarks |
| Summaries | A list of Daily Feature Usage objects. Empty when no rows match. | Returned on success. |
| Result | This is either 0 (=success) or 1 (=error). | Always returned. |
| Message | The message that provides additional information about the result. A successful result returns null. In case of an error, a short message describes the error. | Always returned. |
Example Results
{
"summaries": [
{
"id": 123,
"productId": 3349,
"keyId": 123456,
"key": "AAAAA-BBBBB-CCCCC-DDDDD",
"dateUtc": "2026-11-15",
"featureName": "PDF Export",
"eventName": "used",
"eventCount": 42,
"firstUsedUtc": 1794736800,
"lastUsedUtc": 1794767400
}
],
"result": 0,
"message": null
}
Errors
| Error |
| Access denied. |
| The input parameters were incorrect. |
| Could not find the product. |
| Could not find the key. |
| FeatureName and EventName must each contain at most 100 characters. |
| The 'Start' parameter has the wrong format. |
| The 'End' parameter has the wrong format. |
| The end date cannot be before the start date. |
| Could not retrieve daily feature usage. Please try again. |
Remarks
- These summaries describe recorded events, not which features are enabled on a license. Recent events may take several minutes to appear.
- Dates use the event occurrence time in UTC. Late-arriving events can update earlier daily rows.
- Row IDs support pagination, not change tracking. Re-query the relevant date range to pick up updated counts; continuing only after the highest previously seen Id will miss changes to existing rows.
- Use NewestFirst=true to start at the highest row IDs without a cursor. To report recent activity dates, also set Start and End: an older row can receive new events without changing its Id.
- Keep the same filters while paging. The response is a current page of data, not a fixed snapshot across multiple requests.
- Events without a product or license remain included when no corresponding filter or access-token restriction excludes them.
- Historical rows remain available after a product or license is deleted. Explicit product and license filters must identify records still owned by the account.
- Each row includes KeyId (the global license ID) and Key (the current license string). Key is empty when the license is unassociated or no longer available to the account; historical IDs and counts remain unchanged.
- Product and license restrictions on the access token apply even when the corresponding request filter is omitted. Invalid or inaccessible references return an error.
- For a distinct reporting-license total across several days or features, count distinct non-null KeyId values across all relevant rows. EventCount counts events; different event names do not necessarily represent separate uses.