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

Compare a manhole inspection connection against the duct it refers to

Prev Next
Post
/manhole-connection-comparison/

Operation is used to compare one BRTilslutning connection of a manhole inspection against the KeyAqua duct the network holds for it - whether the pipes the inspection found at a manhole are the pipes the network claims.

The manhole is resolved from the inspection's confirmed link, then its position identifier (Broendnr), then the nearest manhole to its own coordinates. The duct is resolved from that manhole's connected ducts, narrowed by flow direction. A single candidate is used as is. Where several remain, a Tilloebspunkt naming a manhole the network holds selects the duct running between the two; otherwise dimension is the tiebreak, and a still ambiguous result returns the candidates for the caller to pick from.

A connection the network holds no duct for is a result rather than an error: the response carries a null matched_snsewerduct_id.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
snsewerduct_id
integer

Optional manual pick - if provided, this duct is compared instead of the resolved one. Must be connected to the resolved manhole.

snsewernode_id
integer

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

tilslutning_guid
string Required

GUID of the BRTilslutning connection to compare

tolerance
number (float)

Maximum auto-match distance in meters when the manhole is resolved by proximity. Defaults to 0.2 (20 cm).

Responses
200

Comparison result

Expand All
object
candidate_snsewerduct_ids
Array of integer

Ducts at the manhole this connection could refer to, returned when none resolved outright.

integer
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_snsewerduct_id
integer

Id of the duct this connection refers to. Null when the network holds no duct for it, or when several candidates fit.

review_state
string | null

What a user decided about this connection, or null while nobody has judged it. updated is set by /manhole-connection-duct-diff/ when a write succeeds; the other two are recorded by /manhole-connection-review/ and write nothing to the network.

Valid values[ "updated", "reviewed", "disabled_from_update" ]
reviewed_by
string | null

Username of the user who judged the connection; null while unreviewed.

reviewed_ts
string (date-time) | null

When the connection was judged; null while unreviewed.

snsewernode_id
integer

Id of the manhole the inspection was resolved to.

400

There was an error in request. Usually field validation failed, or no manhole could be resolved for the inspection.

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