name: agg_by
description: >-
  The optional `agg_by` parameter can be provided explicitly, regardless if it is needed for a particular query.

  - Providing `agg_by=isrc` is necessary for queries that do not explicitly provide an isrc in the query
  parameters. For example, to get streams returned grouped by ISRC by querying with only `artist_id`.

  - Providing `agg_by=artist` is necessary for queries that do not explicitly provide an artist_id in the query
  parameters. This option is typically redundant as clients generally provide an `artist_id` without
  `agg_by=isrc` for the same effect.
in: query
required: false
schema:
  $ref: '../schemas/properties/agg_by.yaml'
example: 'isrc'