Skip to main content
GET
/
v1
/
agents
/
{agentId}
/
trust-history
Trust Score History
curl --request GET \
  --url https://api.truthlocks.com/v1/agents/{agentId}/trust-history \
  --header 'X-API-Key: <api-key>'
{
  "history": [
    {
      "score": 0.5,
      "timestamp": "2023-11-07T05:31:56Z",
      "factors": {}
    }
  ]
}
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.
​
total
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[]