List Provider Trust Records — GET /v1/trust/providers

Retrieve trust records for all providers, including reputation score and blocklist status. Blocked providers are rejected at invocation time.

Returns the current trust record for every known provider. Use this endpoint to audit reputation scores and identify blocked providers before invoking any of their agents.

Response

Returns { "items": [ProviderTrustRecord] }.

items · array

Array of ProviderTrustRecord objects, one per known provider.

Show ProviderTrustRecord

provider_id · string · required

The unique identifier of the provider.

reputation_score · number (float) · required

Current reputation score for this provider, derived from invocation history and verification outcomes across all their agents.

blocked · boolean · required

Whether this provider is currently blocked. Invocations against any agent belonging to a blocked provider return HTTP 403.

block_reason · string

Human-readable explanation of why the provider was blocked. Present only when blocked is true.

updated_at · string (ISO 8601) · required

UTC timestamp of the most recent update to this trust record.

Example

curl http://your-node:8042/v1/trust/providers

Example response

{
  "items": [
    {
      "provider_id": "acme-labs",
      "reputation_score": 0.98,
      "blocked": false,
      "updated_at": "2025-01-15T10:35:00Z"
    },
    {
      "provider_id": "untrusted-co",
      "reputation_score": 0.22,
      "blocked": true,
      "block_reason": "repeated policy violations",
      "updated_at": "2025-01-13T14:20:00Z"
    }
  ]
}