Returns value delivered over a range: feature usage weighted by each feature's value score, as a time series plus per-feature and per-plan breakdowns. Weights apply when the report runs, so re-weighting a feature also re-values its history.
const url = 'https://example.com/api/v1/provision/admin/reports/feature-value?period=day';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/provision/admin/reports/feature-value?period=day'Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”OK
Value delivered over a time range: recorded feature usage multiplied by each feature’s
relative value weight (FeatureCatalogDto.ValueScore). Weights are applied when the
report is generated, so re-weighting a feature also re-values its history.
Aggregation is entitlement-level; no end-user identity is carried.
object
Total value delivered across the whole range.
Value per bucket, oldest first, bucketed by the requested period.
One bucket of the value-delivered time series.
object
Start of the bucket (UTC).
Value delivered within the bucket.
Per-feature contribution over the range, highest value first.
One feature’s contribution to the value delivered over the range.
object
Feature identifier as recorded on the usage events.
The weight applied; null when the feature has no weight configured.
Number of usage records in the range.
Usage count multiplied by the weight.
Per-plan contribution over the range, highest value first.
One plan’s contribution to the value delivered over the range.
object
Assigned plan name, or a placeholder for entitlements with no plan.
Usage records whose feature could not be resolved to a catalog entry, and so contributed no value.
Value delivered over a time range: recorded feature usage multiplied by each feature’s
relative value weight (FeatureCatalogDto.ValueScore). Weights are applied when the
report is generated, so re-weighting a feature also re-values its history.
Aggregation is entitlement-level; no end-user identity is carried.
object
Total value delivered across the whole range.
Value per bucket, oldest first, bucketed by the requested period.
One bucket of the value-delivered time series.
object
Start of the bucket (UTC).
Value delivered within the bucket.
Per-feature contribution over the range, highest value first.
One feature’s contribution to the value delivered over the range.
object
Feature identifier as recorded on the usage events.
The weight applied; null when the feature has no weight configured.
Number of usage records in the range.
Usage count multiplied by the weight.
Per-plan contribution over the range, highest value first.
One plan’s contribution to the value delivered over the range.
object
Assigned plan name, or a placeholder for entitlements with no plan.
Usage records whose feature could not be resolved to a catalog entry, and so contributed no value.
Examplegenerated
{ "generatedAtUtc": "2026-04-15T12:00:00Z", "totalValue": 1, "timeSeries": [ { "bucket": "2026-04-15T12:00:00Z", "value": 1 } ], "byFeature": [ { "featureId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "featureCode": "example", "featureName": "example", "valueScore": 1, "usageCount": 1, "value": 1 } ], "byPlan": [ { "planName": "example", "value": 1, "usageCount": 1 } ], "unattributedUsageCount": 1}Value delivered over a time range: recorded feature usage multiplied by each feature’s
relative value weight (FeatureCatalogDto.ValueScore). Weights are applied when the
report is generated, so re-weighting a feature also re-values its history.
Aggregation is entitlement-level; no end-user identity is carried.
object
Total value delivered across the whole range.
Value per bucket, oldest first, bucketed by the requested period.
One bucket of the value-delivered time series.
object
Start of the bucket (UTC).
Value delivered within the bucket.
Per-feature contribution over the range, highest value first.
One feature’s contribution to the value delivered over the range.
object
Feature identifier as recorded on the usage events.
The weight applied; null when the feature has no weight configured.
Number of usage records in the range.
Usage count multiplied by the weight.
Per-plan contribution over the range, highest value first.
One plan’s contribution to the value delivered over the range.
object
Assigned plan name, or a placeholder for entitlements with no plan.
Usage records whose feature could not be resolved to a catalog entry, and so contributed no value.
Examplegenerated
{ "generatedAtUtc": "2026-04-15T12:00:00Z", "totalValue": 1, "timeSeries": [ { "bucket": "2026-04-15T12:00:00Z", "value": 1 } ], "byFeature": [ { "featureId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "featureCode": "example", "featureName": "example", "valueScore": 1, "usageCount": 1, "value": 1 } ], "byPlan": [ { "planName": "example", "value": 1, "usageCount": 1 } ], "unattributedUsageCount": 1}Bad Request
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Unauthorized
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Forbidden
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}