> ## Documentation Index
> Fetch the complete documentation index at: https://help.cryptolens.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Daily Feature Usage

> Retrieve daily feature usage summaries by UTC date, product, feature name, event name and license.

Retrieve [daily feature usage summaries](https://help.cryptolens.io/api-reference/generated/model/DailyFeatureUsage.md)
by UTC date, product, feature name, event name and license.

Summaries contain events recorded with [RegisterEvent or RegisterEvents](https://help.cryptolens.io/api-reference/generated/RegisterEvent.md).
Use an access token with **Usage Analytics** permission.

### Parameters

This method is accessed by
[https://api.cryptolens.io/api/ai/GetDailyFeatureUsage](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](https://help.cryptolens.io/api-reference/generated/model/DailyFeatureUsage.md) 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

```text theme={null}
{
  "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.

[View the original Web API reference](https://app.cryptolens.io/docs/api/v3/GetDailyFeatureUsage)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.