|
|
get:
|
|
|
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.
|