# Grouped record aggregates

Build-time release reference. Runtime readiness, deployment, payment settlement and external indexing are not evaluated here. Prices are proposed; this file cannot authorize execution or payment.

WHEN TO USE: Summarize up to 1,000 records with count/sum/avg/min/max, grouped by up to 5 JSON Pointer fields. Up to 20 uniquely named metrics. Group order follows first occurrence; missing keys are distinguished from null through a parallel missing array. Numeric metrics ignore missing/null, reject other non-numbers and overflow; empty sum/count are 0 and empty avg/min/max are null. No groupBy returns one global group, even for empty input. Maximum 100,000 characters and depth 32.

Release: 0.29.0. Built: 2026-10-06T15:38:00Z.

## Choose for
- Calculate count/sum/avg/min/max over supplied bounded records.

## Outside this profile
- Database queries, streaming analytics, or arbitrary formulas.

Proposed nominal USD 0.005 per successful call; payer fees excluded. No verified runtime availability.

- [Exact release contract](/reference/services/records-aggregate.json)
- [Input schema](/reference/schemas/records-aggregate.input.json)
- [Output schema](/reference/schemas/records-aggregate.output.json)
- [Fixed example](/reference/examples/records-aggregate.json)
- [Complete HTML reference](/discover/tools/records-aggregate)