Skip to main content
GET
Get Score Trend

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

start_date
string<date-time>
required

Start of the time range (ISO 8601)

end_date
string<date-time>
required

End of the time range (ISO 8601)

granularity
enum<string>
default:day

Time bucket granularity

Available options:
day,
week,
month
asset_fqn
string | null

Fully qualified name to scope the trend (e.g. service.database.schema.table)

assessment_type
string | null

Filter by assessment type

weight_overrides
string | null

JSON object mapping dimension UUIDs to weights, e.g. {"": 0.5}

Response

Successful Response

Score trend over a time range.

scope
string
required

Scope level of the trend

Example:

"service"

entity
EntityIdentifier · object
required

Entity identifier for the scope

start_date
string<date-time>
required

Start of the time range (ISO 8601)

Example:

"2024-01-01T00:00:00Z"

end_date
string<date-time>
required

End of the time range (ISO 8601)

Example:

"2024-01-31T23:59:59Z"

granularity
string
required

Time bucket granularity

Examples:

"day"

"week"

"month"

data_points
TrendDataPoint · object[]
required

Trend data points