get:
  operationId: patientFundusByPractice
  tags:
    - Patient
  summary: Get per-patient funduscopy status for one GP practice
  description: |-
    Returns patients that have an indication for requiring funduscopy, taking into account the medical dossier of each patient as well as the relevant care group's policies.
    
    For each patient, information about their funduscopy status as well as basic personal information is provided.
  parameters:
    - $ref: '../zoo-api.yaml#/components/parameters/AgbGP'
    - name: purpose
      in: query
      required: true
      description: |-
        A key describing the purpose of requesting funduscopy status of many patients.
        
        Affects what data is supplied (for example, whether personally identifying information is provided), and whether certain
        filters are applied.
        
        * `fundus-broker` – An entity that takes care of arranging appointments between patients and funduscopy professionals.
        * `gp` – Medical personnel reviewing their funduscopy-relevant patient population.
        * `reporting` – Reporting on the status of the funduscopy-relevant patient population as a whole.
        
        The `reporting` purpose limits PII, the `fundus-broker` purpose applies filtering as per the preferences of the care group's policies.
      schema:
        type: string
        enum: ['fundus-broker', 'gp', 'reporting']
    - name: director
      in: query
      required: false
      description: |-
        If present, filter the returned population on the registered director for funduscopy.
        
        * `gp` – Returns only those patients whose most recent registration of responsible-for-funduscopy is 'The GP'.
        * `specialist` – Returns only those patients whose most recent registration of responsible-for-funduscopy is 'The specialist'.
        * `unknown` – Returns only those patients whose most recent registration of responsible-for-funduscopy is not present, registered as 'Unknown', or has an invalid registration.
        
        If not present, no filtering is applied.
      schema:
        type: string
        enum: ['gp', 'specialist', 'unknown', '']
    - $ref: '../zoo-api.yaml#/components/parameters/Pretty'
    - $ref: '../zoo-api.yaml#/components/parameters/RefDateDefaultToday'
    - $ref: '../zoo-api.yaml#/components/parameters/Authorization'
  responses:
    '200':
      description: All patients where funduscopy status is relevant is returned.
      content:
        application/json:
          schema:
            type: object
            required:
              - refDate
              - practice
            properties:
              dict:
                $ref: '../schemas/TermsDictionary.yaml'
              refDate:
                $ref: ../schemas/date.yaml
                description: |-
                  The date used for all calculations: Any time spans are relative to this date, any measurement requirements
                  as stated in the care group's policies such as 'must be registered every year or cannot be considered' are applied
                  to this date, anything that occured after this date is ignored.
                example: '2024-04-01'
              practice:
                $ref: "../schemas/fundus-status.yaml"
    '400':
      description: The request is invalid; for example, it doesn't contain the required `agb` parameter.
    '401':
      $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
    '403':
      description: Indicated group is known but has not authorized ZOO to share this information with signer.