Skip to content
Lark
Book a demoContact usGet started
API Reference
Pricing Metrics

Create Pricing Metric Summary

post/pricing-metrics/{pricing_metric_id}/summary

Create Pricing Metric Summary

Path ParametersExpand Collapse
pricing_metric_id: string
Body ParametersExpand Collapse
period: Period { end, start, inclusive_end, inclusive_start }

The period that the summary should be computed over.

end: string
formatdate-time
start: string
formatdate-time
inclusive_end: optional boolean
inclusive_start: optional boolean
subject_id: string

The ID or external ID of the subject that the summary should be computed for.

dimensions: optional array of string

The dimensions by which the events are grouped to compute the pricing metric.

period_granularity: optional "hour" or "day" or "week"

The granularity of the period that the summary should be computed over.

Accepts one of the following:
"hour"
"day"
"week"
ReturnsExpand Collapse
id: string

The ID of the pricing metric summary.

dimension_coordinates: map[string]

The dimension coordinates that the summary is for.

period: Period { end, start, inclusive_end, inclusive_start }

The period that the summary is computed over.

end: string
formatdate-time
start: string
formatdate-time
inclusive_end: optional boolean
inclusive_start: optional boolean
pricing_metric_id: string

The ID of the pricing metric that the summary is for.

subject_id: string

The ID of the subject that the summary is for.

value: string

The computed value of the pricing metric for the period. If the pricing metric does not have any usage events for the period, this will be null.

Create Pricing Metric Summary
curl https://api.uselark.ai/pricing-metrics/$PRICING_METRIC_ID/summary \
    -H 'Content-Type: application/json' \
    -H "X-API-Key: $LARK_API_KEY" \
    -d '{
          "period": {
            "end": "2025-11-01T00:00:00Z",
            "start": "2025-10-01T00:00:00Z"
          },
          "subject_id": "subj_VyX6Q96h5avMho8O7QWlKeXE"
        }'
[
  {
    "id": "pmtr_sum_vqXWIKBYia15D5dNyCLLlsa4",
    "dimension_coordinates": {
      "foo": "string"
    },
    "period": {
      "end": "2025-11-01T00:00:00Z",
      "start": "2025-10-01T00:00:00Z",
      "inclusive_end": false,
      "inclusive_start": true
    },
    "pricing_metric_id": "pmtr_GlX5Tcm2HOn00CoRTFxw2Amw",
    "subject_id": "subj_VyX6Q96h5avMho8O7QWlKeXE",
    "value": "22.5"
  }
]
Returns Examples
[
  {
    "id": "pmtr_sum_vqXWIKBYia15D5dNyCLLlsa4",
    "dimension_coordinates": {
      "foo": "string"
    },
    "period": {
      "end": "2025-11-01T00:00:00Z",
      "start": "2025-10-01T00:00:00Z",
      "inclusive_end": false,
      "inclusive_start": true
    },
    "pricing_metric_id": "pmtr_GlX5Tcm2HOn00CoRTFxw2Amw",
    "subject_id": "subj_VyX6Q96h5avMho8O7QWlKeXE",
    "value": "22.5"
  }
]