[api] pop statistics now returns a JSON object instead of an array with one k/v pair in it, '"cohorts": array-returned-before'.

paths/population_statistics.yaml

@@ -47,41 +47,44 @@ get:
       content:
         application/json:
           schema:
-            type: array
+            type: object
-            items:
+            properties:
-              type: object
+              cohorts:
-              properties:
+                type: array
-                age:
+                items:
-                  type: integer
-                  minimum: 0
-                  format: int32
-                  example: 42
-                preferredDoctor:
-                  $ref: '../schemas/PatIdentity.yaml#/doctor'
-                insurer:
                   type: object
                   properties:
-                    uzovi:
+                    age:
-                      $ref: '../schemas/insurer-Uzovi.yaml'
+                      type: integer
-                    name:
+                      minimum: 0
-                      type: string
+                      format: int32
-                      description: |-
+                      example: 42
-                        The name of the insurer according the [Vektis register](https://www.vektis.nl/uzovi-register). If the Uzovi is unknown, the Uzovi code is used as the name. The latest register is used to lookup the name for the code.
+                    preferredDoctor:
-                      example: FBTO Zorgverzekeringen N.V.
+                      $ref: '../schemas/PatIdentity.yaml#/doctor'
-                    concern:
+                    insurer:
-                      type: string
+                      type: object
-                      description: The concern name, if any, otherwise the empty string.
+                      properties:
-                      example: ACHMEA
+                        uzovi:
-                    valid:
+                          $ref: '../schemas/insurer-Uzovi.yaml'
-                      type: boolean
+                        name:
-                      description: True if the insurer can be validated using the Uzovi table on the reference date.
+                          type: string
-                gender:
+                          description: |-
-                  $ref: '../schemas/PatIdentity.yaml#/gender'
+                            The name of the insurer according the [Vektis register](https://www.vektis.nl/uzovi-register). If the Uzovi is unknown, the Uzovi code is used as the name. The latest register is used to lookup the name for the code.
-                n:
+                          example: FBTO Zorgverzekeringen N.V.
-                  type: integer
+                        concern:
-                  format: int32
+                          type: string
-                  description: "The number of unique patients in the group."
+                          description: The concern name, if any, otherwise the empty string.
-                  example: 7
+                          example: ACHMEA
+                        valid:
+                          type: boolean
+                          description: True if the insurer can be validated using the Uzovi table on the reference date.
+                    gender:
+                      $ref: '../schemas/PatIdentity.yaml#/gender'
+                    n:
+                      type: integer
+                      format: int32
+                      description: "The number of unique patients in the group."
+                      example: 7
     400:
       description: "Common HTTP semantics, see the response body."
     401: