Get Trust Score

Retrieve the current trust score for a machine agent

Returns the most recently computed trust score for a specific agent. This is a lightweight read that returns cached data — it does not trigger a recomputation. If the score is stale, call the Compute Trust Score endpoint to refresh it.

Trust scores are used across the platform for witness eligibility, delegation authorization, and policy evaluation.

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.

Response

agent_id · string

The agent identifier.

score · number

The current trust score as a float between 0.0 and 1.0.

factors · object

Breakdown of the individual factors that contributed to the score.

Show Factor fields

factors.anomaly_rate · number

Ratio of anomalous events to total events in the scoring window.

factors.uptime · number

Agent availability ratio over the last 30 days.

factors.delegation_depth · integer

Current depth of the agent’s delegation chain.

factors.receipt_count · integer

Total number of valid receipts the agent has accumulated.

updated_at · string

ISO 8601 timestamp of the last score computation.