Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
trust-score
Get Trust Score
curl --request GET \
  --url https://api.truthlocks.com/v1/agents/{agentId}/trust-score \
  --header 'X-API-Key: <api-key>'
{
  "score": 0.5,
  "factors": {},
  "deltas": {},
  "computed_at": "2023-11-07T05:31:56Z"
}
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.
​
updated_at
string
ISO 8601 timestamp of the last score computation.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
agentId
string<uuid>
required

Agent identifier

Response

Trust score

​
score
number<float>
Required range: 0 <= x <= 1
​
factors
object
​
deltas
object
​
computed_at
string<date-time>