Rounding counts for queries with count responses

framework/json/common/beaconCommonComponents.json

@@ -55,6 +55,27 @@
             "pattern": "^\\w[^:]+:.+$",
             "type": "string"
         },
+        "CountAdjustedTo": {
+            "description": "For counts with intentional (e.g. due to privacy concerns) or technical derived imprecision this parameter offers an option to declare the range or limits for the true results.",
+            "items": {
+                "minimum": 1,
+                "type": [
+                    "integer",
+                    "string"
+                ]
+            },
+            "maxItems": 2,
+            "minItems": 1,
+            "type": "array"
+        },
+        "CountPrecision": {
+            "default": "rounded",
+            "enum": [
+                "exact",
+                "rounded"
+            ],
+            "type": "string"
+        },
         "Exists": {
             "description": "Indicator of whether any record was observed in any of the collections queried. This should be non-null.",
             "examples": [

framework/json/responses/sections/beaconCountResponseSection.json

@@ -2,6 +2,14 @@
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "description": "Payload definition for the \"count\" response.",
     "properties": {
+        "countAdjustedTo": {
+            "$ref": "../../common/beaconCommonComponents.json#/$defs/CountAdjustedTo",
+            "description": "List of handovers that apply to this resultset, not to the whole Beacon or to a result in particular."
+        },
+        "countPrecision": {
+            "$ref": "../../common/beaconCommonComponents.json#/$defs/CountPrecision",
+            "description": "List of handovers that apply to this resultset, not to the whole Beacon or to a result in particular."
+        },
         "exists": {
             "$ref": "../../common/beaconCommonComponents.json#/$defs/Exists"
         },

framework/json/responses/sections/beaconResultsets.json

@@ -3,6 +3,12 @@
         "ResultsetInstance": {
             "additionalProperties": true,
             "properties": {
+                "countAdjustedTo": {
+                    "$ref": "../../common/beaconCommonComponents.json#/$defs/CountAdjustedTo"
+                },
+                "countPrecision": {
+                    "$ref": "../../common/beaconCommonComponents.json#/$defs/CountPrecision"
+                },
                 "exists": {
                     "type": "boolean"
                 },
@@ -23,7 +29,7 @@
                     "type": "array"
                 },
                 "resultsCount": {
-                    "description": "Number of results in this Resultset.",
+                    "description": "Precise or approximate number of results in this Resultset.",
                     "type": "integer"
                 },
                 "resultsHandovers": {

framework/src/common/beaconCommonComponents.yaml

@@ -50,6 +50,25 @@ $defs:
         type: string
         examples:
           - 'The provided parameters are incomplete: `start` is missing.'
+  CountAdjustedTo:
+    description: >-
+      For counts with intentional (e.g. due to privacy concerns) or technical
+      derived imprecision this parameter offers an option to declare the range
+      or limits for the true results.
+    type: array
+    minItems: 1
+    maxItems: 2
+    items:
+      type: 
+        - integer
+        - string
+      minimum: 1
+  CountPrecision:
+    enum:
+      - exact
+      - rounded
+    default: rounded
+    type: string
   CURIE:
     pattern: ^\w[^:]+:.+$
     type: string

framework/src/responses/sections/beaconCountResponseSection.yaml

@@ -3,6 +3,14 @@ description: >-
   Payload definition for the "count" response.
 type: object
 properties:
+  countAdjustedTo:
+    description: List of handovers that apply to this resultset, not to the whole
+      Beacon or to a result in particular.
+    $ref: ../../common/beaconCommonComponents.yaml#/$defs/CountAdjustedTo
+  countPrecision:
+    description: List of handovers that apply to this resultset, not to the whole
+      Beacon or to a result in particular.
+    $ref: ../../common/beaconCommonComponents.yaml#/$defs/CountPrecision
   exists:
     $ref: ../../common/beaconCommonComponents.yaml#/$defs/Exists
   numTotalResults:

framework/src/responses/sections/beaconResultsets.yaml

@@ -29,10 +29,16 @@ $defs:
       exists:
         type: boolean
       resultsCount:
-        description: Number of results in this Resultset.
+        description: >-
+          Precise or approximate number of results in this Resultset.
         type: integer
+      countAdjustedTo:
+        $ref: ../../common/beaconCommonComponents.yaml#/$defs/CountAdjustedTo
+      countPrecision:
+        $ref: ../../common/beaconCommonComponents.yaml#/$defs/CountPrecision
       resultsHandovers:
-        description: List of handovers that apply to this resultset, not to the whole
+        description: >-
+          List of handovers that apply to this resultset, not to the whole
           Beacon or to a result in particular.
         $ref: ../../common/beaconCommonComponents.yaml#/$defs/ListOfHandovers
       info: