Skip to main content
GET
Get dataset hand activity

Authorizations

Authorization
string
header
required

Bearer access token issued through OAuth 2.0 client credentials.

Query Parameters

dataset
string
required

Dataset ID from GET /api/v1beta/quality/datasets.

analysis
string

Opaque analysis token from an earlier response. Omit to use the latest measurement.

Response

Hand-activity percentages and coverage

Dataset-level hand-activity percentages and measurement completeness.

active_manipulation_percent
number<double> | null
required

Percentage of assessed footage showing a visible camera-wearer hand purposefully acting on a physical object or material. null when no footage has complete applicable observations. Non-null values are rounded to two decimal places.

Required range: 0 <= x <= 100
analysis
string
required

Opaque measurement token. Matching tokens identify results from the same measurement.

assessed_seconds
number<double>
required

Footage with complete, applicable hand observations, in seconds. This is the denominator every percentage in this response is taken over, so multiplying one by this value converts it into hours of footage.

It is not the duration of the delivery: footage the analysis did not plan to assess, or could not, is not counted here. Read it with coverage_percent, which reports how much of the planned analysis produced values, weighting each planned clip equally rather than each second.

Required range: x >= 0
coverage_percent
number<double> | null
required

Percentage of the planned analysis that successfully produced values used in this response, in [0, 100]. This is measurement completeness, not the percentage of footage that passed quality control. null when the planned result count cannot be determined reliably. Non-null values are rounded to two decimal places.

Required range: 0 <= x <= 100
dataset
string
required

Dataset ID used in the request.

hand_object_contact
null | object
required

Visible camera-wearer hand-object-contact percentages for assessed footage. null when no footage has complete applicable observations.

hand_visibility
null | object
required

Camera-wearer hand-count distribution for assessed footage. null when no footage has complete applicable observations.