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

LevelScoreActionHuman Required
VERY_HIGH90-100PROCEEDNo
HIGH70-89PROCEEDNo
MEDIUM50-69CAUTIONRecommended
LOW25-49FLAGYes
NONE0-24BLOCKYes

Signal Components

SignalMax ScoreDescription
registry40Verified in verified.md registry
brand20Known brand detection
domain_age15Domain age (1pt per year)
ssl10Valid SSL certificate
external15External 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