List quality findings for a dataset version

GET

/v1/dataset-versions/{versionId}/quality-findings

curl -X GET 'https://api.embodiflow.io/v1/dataset-versions/{versionId}/quality-findings' \
  -H 'Authorization: Bearer $EMBODIFLOW_PAT'

Authorization

Send a personal access token with every request.

Authorization: Bearer PAT

Authentication guide

Path parameters

versionIdstringrequired

Query parameters

pageSizenumber
Page size (default 25, maximum 100). Over-maximum is refused.
pageTokenstring
Opaque page token from the previous response.
statusstring
Allowed values
pass
warn
fail
error
not_evaluated
not_applicable
familystring
Allowed values
structure
temporal
clock
sync
alignment
topic
modality
semantics
lerobot
video
stats
action
state
units
episode
consistency
dataset
portability
visual
privacy
human
severitystring
Allowed values
info
warning
error
blockingboolean
scopeTypestring
Allowed values
version
file
episode
recording
topic
feature
interval
checkIdstring
runIdstring (uuid)
Detail truth for a specific run instead of the latest run per version. Named `runId` (not `workflowRunId`) because the permission guard's project-scope resolver treats a `workflowRunId` query hint as the scoping resource and 404s when that run row does not exist — on this route the version is the scoping resource.

Responses

Persisted quality findings for the version. Defaults to the latest workflow run that produced findings; pass runId to read a specific run. Filter family=dataset and scopeType=version for QC0400–QC0419 composition findings.

dataarray<QualityFindingDto>required
- idstringrequired
- checkIdstringrequired
- bindingIdentitystringrequired
- ruleVersionnumberrequired
- familystringrequired
- stagestringrequired
- costTierstringrequired
- originstringrequired
- scopeTypestringrequired
- scopeRefstringrequired
- datasetVersionFileIdstring | nullrequired
- datasetVersionItemIdstring | nullrequired
- statusstringrequired
- severitystringrequired
- blockingone ofrequired
- observedValueone of | nullrequired
- thresholdobject | nullrequired
- elementCountnumber | nullrequired
- violatingCountnumber | nullrequired
- violatingFractionnumber | nullrequired
- messageKeystringrequired
- messagestring | nullrequired
- messageParamsobject | nullrequired
- reasonCodestring | nullrequired
- workflowRunIdstringrequired
- policySnapshotHashstringrequired
- createdAtstringrequired
nextPageTokenstring
Opaque AIP-158 page token. Omitted when the collection is exhausted.
metaobjectrequired
- pageSizenumberrequired
- requestIdstring

Response example

{
  "data": [
    {
      "id": "string",
      "checkId": "string",
      "bindingIdentity": "string",
      "ruleVersion": 0,
      "family": "string",
      "stage": "string",
      "costTier": "string",
      "origin": "string",
      "scopeType": "string",
      "scopeRef": "string",
      "datasetVersionFileId": "string",
      "datasetVersionItemId": "string",
      "status": "string",
      "severity": "string",
      "blocking": false,
      "observedValue": "string",
      "threshold": {},
      "elementCount": 0,
      "violatingCount": 0,
      "violatingFraction": 0,
      "messageKey": "string",
      "message": "string",
      "messageParams": {},
      "reasonCode": "string",
      "workflowRunId": "string",
      "policySnapshotHash": "string",
      "createdAt": "string"
    }
  ],
  "nextPageToken": "string",
  "meta": {
    "pageSize": 0,
    "requestId": "string"
  }
}

Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1

{ "data": [ { "id": "string", "checkId": "string", "bindingIdentity": "string", "ruleVersion": 0, "family": "string", "stage": "string", "costTier": "string", "origin": "string", "scopeType": "string", "scopeRef": "string", "datasetVersionFileId": "string", "datasetVersionItemId": "string", "status": "string", "severity": "string", "blocking": false, "observedValue": "string", "threshold": {}, "elementCount": 0, "violatingCount": 0, "violatingFraction": 0, "messageKey": "string", "message": "string", "messageParams": {}, "reasonCode": "string", "workflowRunId": "string", "policySnapshotHash": "string", "createdAt": "string" } ], "nextPageToken": "string", "meta": { "pageSize": 0, "requestId": "string" } }