Skip to main content
GET
Get a test

Authorizations

Authorization
string
header
required

Personal or account token.

Path Parameters

test_id
string
required

Test identifier.

env_id
string
required

Environment identifier that scopes the request.

Response

Successful Response

definition_type
string
required

Extensible enum. The test's name in the source system — dbt test name for dbt tests, test type for Elementary tests.

Examples:

"not_null"

"unique"

"volume_anomalies"

"source_freshness"

disabled
boolean
required

Whether the test is disabled. A full scan omits disabled tests unless disabled=true is passed; the synced_since and deleted_since feeds always include them, so a sync observes a test being disabled.

id
string
required

Unique test identifier.

name
string
required

Test name.

severity
string
required

Configured severity of the test.

Examples:

"ERROR"

"WARNING"

source_type
string
required

Extensible enum. Integration that synced this test. New values may be added over time.

Examples:

"dbt"

"elementary_cloud"

"python_sdk"

test_type
string
required

Extensible enum. Elementary's category for the test. New values may be added over time.

Examples:

"dbt_test"

"anomaly_detection"

"schema_change"

"source_freshness"

"elementary_cloud"

asset_id
string | null

ID of the asset this test runs on, when known.

column_name
string | null

Column the test runs on, for column-level tests.

config
Config · object

Test configuration as defined in the source system.

deleted_at
string<date-time> | null

Soft-delete timestamp. Present only in the deleted_since feed.

description
string | null

Description from the source platform.

owners
string[]

Owners assigned to the test.

path
string | null

Logical path of the test in its project tree.

project
string | null

Project the test belongs to, when known.

synced_at
string<date-time> | null

When Elementary last synced this test definition. Bumped by definition changes only — new executions do not bump it. Use with synced_since for incremental reads.

tags
string[]

Tags assigned to the test.

updated_at
string<date-time> | null

When the test definition was last updated in the source platform.