2026-10-23 12.00 UTC - There are currently no active events. All systems operational.

Compare a manhole inspection against the nearest KeyAqua snsewernode

Prev Next
Post
/manhole-inspection-comparison/

Operation is used to compare a manhole inspection's BrøndHoveddata fields against its nearest matching snsewernode object (auto-matched by GIS proximity), or against a manually picked snsewernode.

Phase 1: keyaqua_value in the response is always a placeholder (null) - live DB lookup is Phase 2 (see KP-9050).

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
manhole_inspection_id
integer Required

Id of the manhole inspection to compare

snsewernode_id
integer

Optional manual pick - if provided, this snsewernode is used instead of the auto-matched nearest one.

tolerance
number (float)

Maximum auto-match distance in meters. Defaults to 0.2 (20 cm).

Responses
200

Comparison result

Expand All
object
fields
Array of object (ComparisonField)
object
differs
boolean

Whether the two values disagree. Null when no verdict can be reached - the inspector recorded nothing, or the comparison returns a placeholder - so "not comparable" is never rendered as agreement.

field
string

Field name being compared

inspection_value
object

Value from the inspection record. FK fields are shown as a nested {id, txt} object.

keyaqua_value
object

Value from the matched KeyAqua network object. The connection comparison returns the duct's own value here; the inspection and observation comparisons still return a placeholder null.

matched_snsewernode_id
integer

Id of the matched snsewernode (auto-matched or manually picked). Null if no match was found within tolerance.

400

There was an error in request. Usually field validation failed.

object

Fields which failed validation

property*
Array additionalProperties

List of validation errors for this fieldname

401

Authentication credentials are missing or invalid

{
  "details": "Authentication credentials were not provided"
}
object

Standard error response payload

details
string

Detailed description of error

404

Object was not found

{
  "details": "Not found."
}
object

Standard error response payload

details
string

Detailed description of error