Skip to main content
GET
Aggregate asset health scores

Authorizations

Authorization
string
header
required

Personal or account token.

Path Parameters

env_id
string
required

Environment identifier that scopes the request.

Query Parameters

ids
string[] | null

Aggregate only table assets with these ids.

Maximum array length: 1000
source_types
string[] | null

Aggregate only table assets from these source types (e.g. dbt, fivetran).

Maximum array length: 1000
tags
string[] | null

Aggregate only table assets tagged with any of these tags.

Maximum array length: 1000
db_names
string[] | null

Aggregate only table assets in these databases.

Maximum array length: 1000
schema_names
string[] | null

Aggregate only table assets in these schemas.

Maximum array length: 1000
materializations
string[] | null

Aggregate only table assets with these materializations (e.g. table, view, incremental).

Maximum array length: 1000
path
string[] | null

Return only table assets whose path equals one of these paths or is nested under one of them (/-separated, e.g. models/marts matches models/marts/orders.sql; a trailing / is ignored). Repeatable; assets without a path never match.

Maximum array length: 1000

Response

Successful Response

dimensions
DimensionHealthScore · object[]
required

Latest aggregated score per dimension. Dimensions with no results in the last 7 days are omitted.

matched_count
integer
required

Number of table assets you can view that match the filters, whether or not they have test results in the window. 0 when nothing matches.

total
AggregatedHealthScoreBucket · object
required

Weighted score across all dimensions for the whole matching asset set, using the environment's configured dimension weights. Aggregated across the assets' test results, not an average of per-asset scores.