> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt > Use this file to discover all available pages before exploring further. # Get custom events aggregation numeric counts > Retrieves aggregated statistics for numeric events event values produced by a selected prompt over a specified time window. Scope & filters: • promptUuid – The prompt to aggregate (required). Time window & interval: • A time range (startTimeMs → endTimeMs, epoch ms) is required and is used exactly as provided. • If an interval is supplied (e.g., MINUTELY, QUARTERHOURLY, HOURLY), events are bucketed at that granularity. • Aggregation is always performed in the device’s local timezone. Buckets are computed relative to each device’s timezone, then evaluated within the exact provided window. Response: • Per interval bucket, returns numeric aggregates derived from raw values: count, sum, min, max, average. • Includes minValueTimestampMs and maxValueTimestampMs indicating when min/max occurred within the bucket (if available). • Bucket timestamps are returned as epoch ms. Notes: • Only numeric prompt types are valid for this endpoint. ## OpenAPI ````yaml https://api2.rhombussystems.com/api/openapi/public.json post /api/report/getCustomEventsNumericCounts openapi: 3.0.1 info: contact: email: developer@rhombussystems.com description: >- This API is for use by Rhombus customers and partners. ## Authentication All requests require two headers: - `x-auth-scheme` — The authentication scheme identifier. Use `api-token` for standard API key auth, or `partner-api-token` for partner API auth. - `x-auth-apikey` — Your Rhombus API key. Example: ``` POST /api/camera/getMinimalCameraStateList x-auth-scheme: api-token x-auth-apikey: YOUR_API_KEY Content-Type: application/json ``` title: Rhombus API version: '1.0' servers: - description: Production Server url: https://api2.rhombussystems.com security: - ApiKeyAuth: [] paths: /api/report/getCustomEventsNumericCounts: post: tags: - Report Webservice summary: Get custom events aggregation numeric counts description: "Retrieves aggregated statistics for numeric events event values produced by a selected prompt over a specified time window.\nScope & filters:\n\t•\tpromptUuid – The prompt to aggregate (required).\n\nTime window & interval:\n\t•\tA time range (startTimeMs → endTimeMs, epoch ms) is required and is used exactly as provided.\n\t•\tIf an interval is supplied (e.g., MINUTELY, QUARTERHOURLY, HOURLY), events are bucketed at that granularity.\n\t•\tAggregation is always performed in the device’s local timezone. Buckets are computed relative to each device’s timezone, then evaluated within the exact provided window.\n\nResponse:\n\t•\tPer interval bucket, returns numeric aggregates derived from raw values: count, sum, min, max, average.\n\t•\tIncludes minValueTimestampMs and maxValueTimestampMs indicating when min/max occurred within the bucket (if available).\n\t•\tBucket timestamps are returned as epoch ms.\n\nNotes:\n\t•\tOnly numeric prompt types are valid for this endpoint.\n" operationId: getCustomEventsNumericCounts parameters: - description: >- Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key. example: api-token in: header name: x-auth-scheme required: true schema: type: string default: api-token enum: - api-token - api - partner-api-token - partner-api requestBody: content: application/json: schema: $ref: '#/components/schemas/Report_GetCustomLLMWSRequest' responses: '200': content: application/json: schema: $ref: '#/components/schemas/Report_GetCustomLLMNumericWSResponse' description: OK components: schemas: Report_GetCustomLLMWSRequest: type: object description: Request object for custom LLM reports. properties: endTimeMs: type: integer format: int64 description: >- The end timestamp (in Unix epoch milliseconds) of the selected interval example: 1640998800000 nullable: true interval: $ref: '#/components/schemas/ReportIntervalEnum' promptUuid: type: string format: RUUID description: base 64 (url-safe) uuid string example: AAAAAAAAAAAAAAAAAAAAAA nullable: true startTimeMs: type: integer format: int64 description: >- The start timestamp (in Unix epoch milliseconds) of the selected interval example: 1640995200000 nullable: true Report_GetCustomLLMNumericWSResponse: type: object description: Response object for custom LLM numeric reports. properties: error: type: boolean nullable: true errorMsg: type: string nullable: true reports: type: object additionalProperties: type: array description: Map of numeric count reports items: $ref: '#/components/schemas/NumericAggregationValue' nullable: true description: Map of numeric count reports nullable: true warningMsg: type: string nullable: true ReportIntervalEnum: type: string description: Report interval for filtering face events enum: - MINUTELY - QUARTERHOURLY - HOURLY - DAILY - WEEKLY - MONTHLY NumericAggregationValue: type: object description: Map of numeric count reports properties: average: type: number format: double nullable: true eventCount: type: integer format: int64 nullable: true localDate: type: string nullable: true max: type: number format: double nullable: true maxValueTimestampMs: type: integer format: int64 nullable: true min: type: number format: double nullable: true minValueTimestampMs: type: integer format: int64 nullable: true sum: type: number format: double nullable: true timestampMs: type: integer format: int64 nullable: true utcDate: type: string nullable: true securitySchemes: ApiKeyAuth: description: >- Your Rhombus API key. Must be accompanied by the `x-auth-scheme` header set to `api-token` (or `partner-api-token` for partner endpoints). in: header name: x-auth-apikey type: apiKey ````