get:
  tags:
    - Frequent users
  operationId: populationFrequentUserCount
  summary: "Patient population projected on the number of visits"
  parameters:
    - name: periodStart
      in: query
      description: Start of the period (including) to analyze.
      schema: 
        $ref: ../schemas/date.yaml
    - name: periodEnd
      in: query
      description: End of the period (excluding) to analyze. 
      schema: 
        $ref: ../schemas/date.yaml
    - name: doctorAgbCodes
      in: query
      description: Any valid AGB-code.
      example: 01015678,01018765,01014321
      schema:
        type: array
        items:
          type: number
    - name: doctorCodes
      in: query
      description: Code of the doctor as known in the HIS.
      schema: 
        type: array
        items: 
          $ref: ../schemas/med_dossier/Practitioner.yaml
    - name: featCodes
      in: query
      description: "The feats which are identified as time consuming or otherwise taking effort of the practice, defaults to: 12011,12411,12001,12401,12010,12410."
      schema: 
        $ref: ../schemas/med_dossier/FeatCode.yaml
    - name: patients
      in: query
      schema:
        $ref: ../schemas/pat-patId.yaml
  responses:
    200:
      description: "An object with at least the frequency property which holds an array with the number of visits and their frequency."
      content:
        application/json:
          schema:
            type: object
            required:
              - frequencies
            properties:
              frequencies:
                type: array
                items:
                  type: object
                  properties:
                    visits:
                      type: number
                    frequency:
                      type: number
                  example: 
                    - {visits: 1, frequency: 355} 
                    - {visits: 2, frequency: 240}
                    - {visits: 4, frequency: 25}
    401:
      $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
    403:
      $ref: '../zoo-api.yaml#/components/responses/NotToBeShare'
    404:
      $ref: '../zoo-api.yaml#/components/responses/PatNotFound'