OpenSearch/docs/java-api/aggregations/bucket/children-aggregation.asciidoc

[[java-aggs-bucket-children]]
==== Children Aggregation

Here is how you can use
{ref}/search-aggregations-bucket-children-aggregation.html[Children Aggregation]
with Java API.


===== Prepare aggregation request

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

[source,java]
--------------------------------------------------
AggregationBuilder aggregation =
    AggregationBuilders
        .children("agg", "reseller"); <1>
--------------------------------------------------
1. `"agg"` is the name of the aggregation and `"reseller"` is the child type

===== Use aggregation response

Import Aggregation definition classes:

[source,java]
--------------------------------------------------
import org.elasticsearch.search.aggregations.bucket.children.Children;
--------------------------------------------------

[source,java]
--------------------------------------------------
// sr is here your SearchResponse object
Children agg = sr.getAggregations().get("agg");
agg.getDocCount(); // Doc count
--------------------------------------------------