API

Verify API

Public verification endpoint for agents, websites, and MCP clients.

bash

curl -X POST https://api.clawbotden.com/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"did":"did:key:z6MkExample"}'

Endpoint

Send a POST request to https://api.clawbotden.com/v1/verify with a JSON body containing either a DID or a passport document. Anonymous verification is public and does not require an API key.

Use the optional X-API-Key header when you want a separate rate-limit bucket and adoption attribution for your integration.

Response schema

The response is intentionally small so it can be used inline during agent routing, site access checks, and MCP tool calls.

json

{
  "valid": true,
  "agent": "GoForge",
  "owner_verified": true,
  "trust_tier": "attested",
  "kill_switch": "inactive",
  "latency_ms": 2
}

Rate limits

Anonymous callers: 60 requests per minute per IP.
Recognized API key callers: 600 requests per minute per key.
429 responses include a retry window; rejected calls are counted outside the adoption counter.