---
name: check-an-agent
description: Read another AI agent's public behavioral integrity record from VIGIL (gate, BII, sealed ledger count and head, last event time) before acting on its output. No API key needed or accepted.
---

# Check an agent

VIGIL scores an agent's reported behavior on every event, gates it (pass, hold, alert, collapse) and seals each record on a hash-chained ledger the database will not let anyone edit. An agent's owner can make that record public. These two reads need no key. Never send a key to them.

## One agent

```
GET https://vigil.supertruth.ai/public/agents/{org_slug}/{agent_id}
```

`200` with:

```json
{
  "org": "supertruth",
  "agent_id": "truth-agent",
  "name": "Truth Agent (supertruth.ai)",
  "kind": "production",
  "gate": "pass",
  "bii": 0.9375,
  "ledger_records": 25,
  "ledger_head": "1e00c299...",
  "last_event_at": "2026-09-09T16:41:09Z",
  "observed": true,
  "policy_digest": "5d8db364...",
  "public_links": [{ "kind": "website", "url": "https://supertruth.ai" }],
  "verify_url": "https://docs.vigil.supertruth.ai/concepts/ledger#verify-offline-trusting-nobody"
}
```

`404` means: not public, not active, not in that org, or no such agent. The route does not say which.

## Every public agent in an org

```
GET https://vigil.supertruth.ai/public/agents/{org_slug}?limit=50&offset=0
```

`200` with `{ "org", "total", "limit", "offset", "agents": [ ...records as above ] }`. `404` when the org has no public agent.

## How to read it

- `gate` is the current decision. `pass` means BII 0.75 or above. `hold`, `alert` and `collapse` mean the agent's outputs are being held for review or stopped; treat its recent output accordingly.
- `bii` is 0.0 to 1.0. It is the value VIGIL stored at the last scored event, not something computed for you.
- `ledger_records` and `ledger_head` describe a chain that only grows. If the head you saw earlier is no longer in the owner's export, the ledger was rewritten and the record should not be trusted.
- `public_links` are the owner's own claims. VIGIL does not verify them.

## Limits and caching

60 requests a minute per client address; the response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. Responses may be cached for 60 seconds (`Cache-Control: public, max-age=60`).

## What it proves

That a VIGIL-registered runtime reporting as this agent has this behavior record and that the ledger holding it has not been edited. It does not prove who operates the agent, who holds its keys, or that an account anywhere else belongs to it. Actions the runtime never reported are not on the record.

Method: https://docs.vigil.supertruth.ai/concepts/bii. Full page for people: https://app.vigil.supertruth.ai/a/{org_slug}/{agent_id}. Docs: https://docs.vigil.supertruth.ai/check-an-agent.