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

Compare every observation of a TV inspection against its snsewerduct

Prev Next
Post
/tv-inspection-observation-comparison/

Operation is used to run /tv-observation-comparison/ for every observation of one inspection in a single request, so a duct graph does not need one call per observation. Each entry is the single comparison's response plus the observation id, ordered by distance along the duct.

A branch observation (GR and the other connection codes) records nothing of the duct, so its status follows /tv-observation-branch-comparison/ instead, with no branch near it reported as needs_attention: the branch is undocumented. Its other fields stay the duct comparison's.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
tolerance
number (float)

Maximum auto-match distance in meters for an unlinked inspection. Defaults to 0.2 (20 cm).

tv_inspection_id
integer Required

Id of the TV inspection whose observations are compared

Responses
200

One comparison per observation

Array of object
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_snsewerduct_id
integer

Id of the snsewerduct compared against - the inspection's confirmed duct, else the nearest within tolerance. Null if none.

review_state
string | null

The observation's review state. Null if nobody has judged it.

Valid values[ "updated", "reviewed", "disabled_from_update" ]
status
string

What a duct graph colours the observation by

Valid values[ "disabled_from_update", "not_compared", "needs_attention", "all_good" ]
tv_observation_id
integer

Id of the compared observation

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

403

The user may not view this TV inspection or the sewer ducts it is compared against.

404

Object was not found

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

Standard error response payload

details
string

Detailed description of error