> ## 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 All Agent Trust Records — GET /v1/trust/agents

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

Returns the current trust record for every known agent. Use this endpoint to audit reputation scores and identify blocked agents before invoking them.

## Response

Returns `{ "items": [AgentTrustRecord] }`.

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

  <Expandable title="AgentTrustRecord">
    <ResponseField name="agent_id" type="string" required>
      The unique identifier of the agent.
    </ResponseField>

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

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

    <ResponseField name="block_reason" type="string">
      Human-readable explanation of why the agent 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/agents
```

### Example response

```json theme={null}
{
  "items": [
    {
      "agent_id": "stripe-agent",
      "reputation_score": 0.97,
      "blocked": false,
      "updated_at": "2025-01-15T10:35:00Z"
    },
    {
      "agent_id": "legacy-agent",
      "reputation_score": 0.41,
      "blocked": true,
      "block_reason": "policy violation",
      "updated_at": "2025-01-14T08:00:00Z"
    }
  ]
}
```
