[[java-aggs-metrics-stats]]
==== Stats Aggregation

Here is how you can use
{ref}/search-aggregations-metrics-stats-aggregation.html[Stats Aggregation]
with Java API.


===== Prepare aggregation request

Here is an example on how to create the aggregation request:

[source,java]
--------------------------------------------------
StatsAggregationBuilder aggregation =
        AggregationBuilders
                .stats("agg")
                .field("height");
--------------------------------------------------


===== Use aggregation response

Import Aggregation definition classes:

[source,java]
--------------------------------------------------
import org.elasticsearch.search.aggregations.metrics.stats.Stats;
--------------------------------------------------

[source,java]
--------------------------------------------------
// sr is here your SearchResponse object
Stats agg = sr.getAggregations().get("agg");
double min = agg.getMin();
double max = agg.getMax();
double avg = agg.getAvg();
double sum = agg.getSum();
long count = agg.getCount();
--------------------------------------------------

