> ## Documentation Index
> Fetch the complete documentation index at: https://hs-df36fa00.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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] }`.

<ResponseField name="items" type="array">
  Array of `ProviderTrustRecord` objects, one per known provider.

  <Expandable title="ProviderTrustRecord">
    <ResponseField name="provider_id" type="string" required>
      The unique identifier of the provider.
    </ResponseField>

    <ResponseField name="reputation_score" type="number (float)" required>
      Current reputation score for this provider, derived from invocation history and verification outcomes across all their agents.
    </ResponseField>

    <ResponseField name="blocked" type="boolean" required>
      Whether this provider is currently blocked. Invocations against any agent belonging to a blocked provider return HTTP 403.
    </ResponseField>

    <ResponseField name="block_reason" type="string">
      Human-readable explanation of why the provider was blocked. Present only when `blocked` is `true`.
    </ResponseField>

    <ResponseField name="updated_at" type="string (ISO 8601)" required>
      UTC timestamp of the most recent update to this trust record.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl http://your-node:8042/v1/trust/providers
```

### Example response

```json theme={null}
{
  "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"
    }
  ]
}
```
