GET /v1/dataQuality/testCases/testCaseResults/{fqn}

# Get test results
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}"

# Get results with time range
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between?startTs=1769900000000&endTs=1769990000000" \
  -H "Authorization: Bearer {access_token}"

# Add a test result
curl -X POST "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": 1769982800000,
    "testCaseStatus": "Success",
    "result": "Max value 42 is between 1 and 100",
    "testResultValue": [
      {"name": "maxValue", "value": "42"}
    ]
  }'

{
  "data": [
    {
      "timestamp": 1769982800000,
      "testCaseStatus": "Success",
      "result": "Max value 42 is between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "42"
        }
      ]
    },
    {
      "timestamp": 1769896400000,
      "testCaseStatus": "Failed",
      "result": "Max value 150 is not between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "150"
        }
      ]
    }
  ],
  "paging": {
    "total": 2
  }
}

GET

dataQuality

testCases

testCaseResults

{fqn}

GET /v1/dataQuality/testCases/testCaseResults/{fqn}

# Get test results
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}"

# Get results with time range
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between?startTs=1769900000000&endTs=1769990000000" \
  -H "Authorization: Bearer {access_token}"

# Add a test result
curl -X POST "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": 1769982800000,
    "testCaseStatus": "Success",
    "result": "Max value 42 is between 1 and 100",
    "testResultValue": [
      {"name": "maxValue", "value": "42"}
    ]
  }'

{
  "data": [
    {
      "timestamp": 1769982800000,
      "testCaseStatus": "Success",
      "result": "Max value 42 is between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "42"
        }
      ]
    },
    {
      "timestamp": 1769896400000,
      "testCaseStatus": "Failed",
      "result": "Max value 150 is not between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "150"
        }
      ]
    }
  ],
  "paging": {
    "total": 2
  }
}

Test Case Results

Retrieve test case execution results or add new results programmatically. Each result includes a status, timestamp, and detailed result values.

Get Test Case Results

string

required

Fully qualified name (FQN) returned when creating the test case. URL-encode it when necessary.

integer

Start timestamp (epoch milliseconds) to filter results.

integer

End timestamp (epoch milliseconds) to filter results.

Add a Test Case Result

Use POST /v1/dataQuality/testCases/testCaseResults/{fqn} to add a new test result.

string

required

Fully qualified name (FQN) returned when creating the test case. URL-encode it when necessary.

Body Parameters

integer

required

Epoch timestamp (milliseconds) of the test execution.

string

required

Status of the test execution: Success, Failed, or Aborted.

string

Human-readable summary of the test result.

array

required

Array of detailed result values produced by the test.

Show properties

string

required

Name of the result metric.

string

required

Value of the result metric.

GET /v1/dataQuality/testCases/testCaseResults/{fqn}

# Get test results
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}"

# Get results with time range
curl "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between?startTs=1769900000000&endTs=1769990000000" \
  -H "Authorization: Bearer {access_token}"

# Add a test result
curl -X POST "{base_url}/api/v1/dataQuality/testCases/testCaseResults/sample_data.ecommerce_db.shopify.dim_address.shop_id.column_value_max_to_be_between" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "timestamp": 1769982800000,
    "testCaseStatus": "Success",
    "result": "Max value 42 is between 1 and 100",
    "testResultValue": [
      {"name": "maxValue", "value": "42"}
    ]
  }'

{
  "data": [
    {
      "timestamp": 1769982800000,
      "testCaseStatus": "Success",
      "result": "Max value 42 is between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "42"
        }
      ]
    },
    {
      "timestamp": 1769896400000,
      "testCaseStatus": "Failed",
      "result": "Max value 150 is not between 1 and 100",
      "testResultValue": [
        {
          "name": "maxValue",
          "value": "150"
        }
      ]
    }
  ],
  "paging": {
    "total": 2
  }
}

Returns

Get results returns a list of test case result objects for the requested FQN and time range. Add result returns the test case result object that was created.

Response

array

Array of test case result objects.

Show properties

integer

Epoch timestamp (milliseconds) of the test execution.

string

Status of the test: Success, Failed, or Aborted.

string

Human-readable summary of the test result.

array

Detailed result values.

Show properties

string

Name of the result metric.

string

Value of the result metric.

object

Pagination information.

Show properties

integer

Total count of results.

Delete a Test Case Result

Use DELETE /api/v1/dataQuality/testCases/testCaseResults/{fqn}/{timestamp} to delete a single test case result. fqn is the test case’s fully qualified name and timestamp is the result’s timestamp in milliseconds. The request returns the updated test case. The caller needs Delete on either the table the test case belongs to or the test case itself. Callers with neither permission receive 403.

Test Case Status Values

Status	Description
`Success`	The test passed all assertions
`Failed`	The test failed one or more assertions
`Aborted`	The test was aborted due to an error or timeout

Error Handling

Code	Error Type	Description
`401`	`UNAUTHORIZED`	Invalid or missing authentication token
`403`	`FORBIDDEN`	User lacks permission to view or add test results
`404`	`NOT_FOUND`	Test case with given FQN does not exist

API Reference

Data Assets

Collaboration

AI SDK

SDK

Discovery

Lineage

Data Contracts

Teams And Users

Data Governance

Data Quality

Alerts

Incidents

Main Concepts

Test Case Results

Test Case Results

Get Test Case Results

Add a Test Case Result

Body Parameters

Returns

Response

Delete a Test Case Result

Test Case Status Values

Error Handling