get: 
  tags:
    - Population statistics
  operationId: getStatisticsAuthorisation
  summary: Authorisation
  description: Reports the authorisations for group-by items for the specified practice(s). Care groups are allowed to query the authorisations of the underlying practices. Practices are allowed to query their own settings.
  parameters:
    - name: agbs
      in: query
      schema:
        type: array
        items: 
          $ref: ../schemas/agb.yaml
      required: true
      description: The agb of the practice(s) for which the authorisations should be reported.
  responses:
    200:
      description: An array with for each practice an object describing the authorisation settings for the practice and for the care groups.
      content: 
        application/json:
          schema:
            type: array
            items: 
              type: object
              properties:
                practice:
                  $ref: '../schemas/agb.yaml'
                groupBy:
                  type: array
                  items: 
                    type: object
                    properties:
                      item:
                        $ref: ../schemas/StatisticsGroupBy-enum.yaml
                        description: All possible enum values are always in the output.
                      active:
                        type: boolean
                        description: True if authorised, otherwise false.
                caregroups:
                  type: array
                  items:
                    type: object
                    properties:
                      tag:
                        $ref: ../schemas/tag.yaml
                      agb:
                        $ref: '../schemas/agb.yaml'
                      groupBy:
                        $ref: '#/get/responses/200/content/application~1json/schema/items/properties/groupBy'
    400:
      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
    401:
      $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
    404:
      $ref: '../zoo-api.yaml#/components/responses/PatNotFound'