Skip to main content
GET
List violations

Authorizations

Authorization
string
header
required

JWT Bearer token authentication. Include the token in the Authorization header as: Authorization: Bearer <token>. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing.

Query Parameters

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
per_page
integer
default:20

Items per page

Required range: 1 <= x <= 100
asset_fqn
string | null

Filter by asset FQN (prefix match)

service
string | null

Filter by service name

database
string | null

Filter by database name

schema
string | null

Filter by schema name

table
string | null

Filter by table name

severity
enum<string> | null

Filter by severity Severity level of a violation.

Available options:
low,
medium,
high
status
enum<string> | null

Filter by status Lifecycle status of a violation.

Available options:
open,
resolved,
acknowledged,
false_positive
assessment_type
enum<string> | null

Filter by assessment type (metadata or data_quality) Type of assessment a dimension belongs to.

Available options:
metadata,
data_quality
dimension_id
string<uuid> | null

Filter by dimension ID

definition_name
string | null

Filter by violation definition

workflow_run_id
string<uuid> | null

Filter by Prefect workflow run ID

sort_by
enum<string>
default:created_at

Sort field

Available options:
created_at,
updated_at,
severity,
status,
asset_fqn,
service,
database_name,
schema_name,
table_name
sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

Successful Response

Response model for paginated violation list.

violations
ViolationResponse · object[]
required

List of violations

pagination
PaginationMeta · object
required

Pagination metadata