Skip to main content
GET
Trust Score History
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

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

Query Parameters

string
ISO 8601 start timestamp for the history window. Defaults to 30 days ago.
string
ISO 8601 end timestamp for the history window. Defaults to now.
integer
default:"100"
Maximum number of records to return. Range: 1-1000.

Response

string
The agent identifier.
array
Array of historical trust score records, ordered by computed_at ascending.
integer
Total number of records matching the query window (before limit is applied).

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

agentId
string<uuid>
required

Agent identifier

Query Parameters

from
string<date-time>

Start of time range (ISO 8601)

to
string<date-time>

End of time range (ISO 8601)

limit
integer
default:50
Required range: 1 <= x <= 500

Response

Trust score history

history
object[]