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

Match and diff TV observations between two inspections

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

Operation matches TV (CCTV) observations from two inspections by position (+-2 m tolerance) and returns a field-by-field diff for each matched pair. Unlike the KeyAqua comparison endpoints, both sides here are real inspection data, so the diff is computed for real - there is no Phase 2 placeholder involved for this endpoint.

Unmatched observations on either side are included in the response with a null value on the unmatched side.

Security
API Key: Token
Header parameter nameAuthorization

Token issued for API consumer.

Body parameters
object
tv_inspection_ids
Array of integer Required

Exactly two TV inspection ids to compare

Min items2
Max items2
integer
Responses
200

List of matched (and unmatched) observation pairs

Array of object
object
fields_diff
Array of object (TvObservationPairDiffField)
object
differs
boolean

Whether left_value and right_value differ. Null if either side is unmatched (nothing to compare).

field
string

Field name being compared

left_value
object

Value from the left-side observation. Null if this side is unmatched. FK fields are shown as a nested {id, txt} object.

right_value
object

Value from the right-side observation. Null if this side is unmatched. FK fields are shown as a nested {id, txt} object.

obs_left
integer

Id of the left-side observation. Null if only the right side has an observation at this position.

obs_right
integer

Id of the right-side observation. Null if only the left side has an observation at this position.

position_diff
number (float)

Distance in meters between the matched pair. Null if unmatched on one side.

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