Trust Signals
Understanding trust signals and agent guidance in API responses.
Enabling Trust Signals
Add ?signals=true to any verify request:
GET https://verified.md/verify/example.com?signals=true
Trust Level Scale
| Level | Score | Action | Human Required |
|---|---|---|---|
| VERY_HIGH | 90-100 | PROCEED | No |
| HIGH | 70-89 | PROCEED | No |
| MEDIUM | 50-69 | CAUTION | Recommended |
| LOW | 25-49 | FLAG | Yes |
| NONE | 0-24 | BLOCK | Yes |
Signal Components
| Signal | Max Score | Description |
|---|---|---|
| registry | 40 | Verified in verified.md registry |
| brand | 20 | Known brand detection |
| domain_age | 15 | Domain age (1pt per year) |
| ssl | 10 | Valid SSL certificate |
| external | 15 | External checks (requires ?external=true) |
Agent Guidance Object
{
"agent_guidance": {
"action": "PROCEED | CAUTION | FLAG | BLOCK",
"safe_actions": ["payment", "data_sharing", "api_call"],
"max_transaction_usd": 10000,
"requires_human": false,
"reason": "Only for FLAG/BLOCK actions"
}
}
Blocked Domains
Some domains are explicitly blocked. These return:
{
"blocked": true,
"trust_score": 0,
"agent_guidance": {
"action": "BLOCK",
"reason": "Domain is blocked"
}
}
Agent format: /api.md