Trust Score History

Retrieve historical trust score data for a machine agent over time

Returns a time-series of trust score computations for a specific agent. Use this endpoint to visualize trust trends, detect score degradation, and audit score changes following incidents. Results are ordered chronologically (oldest first).

Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

Path Parameters

agent_id · string · required

The unique identifier of the machine agent. Format: maip-agent:ULID.

Query Parameters

from · string

ISO 8601 start timestamp for the history window. Defaults to 30 days ago.

to · string

ISO 8601 end timestamp for the history window. Defaults to now.

limit · integer · default: "100"

Maximum number of records to return. Range: 1-1000.

Response

agent_id · string

The agent identifier.

history · array

Array of historical trust score records, ordered by computed_at ascending.

Show History record fields

history[].score · number

Trust score at the time of computation (0.0-1.0).

history[].factors · object

Factor breakdown at the time of computation.

Show Factor fields

history[].factors.anomaly_rate · number

Anomaly rate at time of computation.

history[].factors.uptime · number

Uptime ratio at time of computation.

history[].factors.delegation_depth · integer

Delegation chain depth at time of computation.

history[].factors.receipt_count · integer

Cumulative receipt count at time of computation.

history[].computed_at · string

ISO 8601 timestamp of when this score was computed.

total · integer

Total number of records matching the query window (before limit is applied).