PolicyCheck API

https://policycheck.tools

curl -X POST https://policycheck.tools/api/check \
  -H "Content-Type: application/json" \
  -d '{"url": "https://amazon.com"}'

curl -X POST https://policycheck.tools/api/check \
  -H "Content-Type: application/json" \
  -d '{"policy_text": "All sales are final. No refunds. 25% restocking fee."}'

{
  "seller_url": "https://amazon.com",
  "risk_score": 1.5,                      // number | null — 0-10 scale
  "risk_level": "low",                    // "low" | "medium" | "high" | "critical" | "unknown"
  "buyer_protection_rating": "A",         // string | null — letter grade A+ through F
  "buyer_protection_score": 85,           // number | null — 0-100 (inverse of risk)
  "risk_factors": [
    {
      "factor": "return_shipping_fee",    // clause type identifier
      "severity": "low",                  // "high" | "medium" | "low"
      "detail": "Buyer pays return shipping costs.",
      "source": "returns",                // "returns" | "legal" | "pricing" | "privacy" | "shipping"
      "found_in": "return_policy",        // which policy page contained this clause
      "severity_note": null               // "standard_tos_boilerplate" when severity was discounted
    }
  ],
  "positives": [                          // consumer-friendly policies found
    "Free shipping on orders over $25"
  ],
  "summary": "3 of 4 policy categories analyzed. Return shipping fee detected.",
  "flags": ["return_shipping_fee"],       // flat array of clause type names
  "fetch_method": "server_fetch",         // "server_fetch" | "client_provided" | "text_input"
  "analysis_status": "partial",           // "complete" | "partial" | "no_content" | "text_provided"
  "confidence": "medium",                 // "high" | "medium" | "low" | "none"
  "analysis_method": "regex_plus_llm",    // "regex_plus_llm" | "regex_only" | "none"
  "analyzed_at": "2026-02-16T11:29:53Z"   // ISO 8601 timestamp
}

curl -X POST https://policycheck.tools/api/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [
          {
            "kind": "data",
            "data": { "seller_url": "https://amazon.com" }
          }
        ]
      }
    }
  }'

{
  "payment": {
    "settled": true,
    "transaction": "0x...",
    "network": "eip155:8453",
    "payer": "0x..."
  },
  "analysis": {
    "risk_score": 1.5,
    "risk_level": "low",
    "flags": ["return_shipping_fee"],
    ...                                   // same fields as /api/check
  }
}

curl https://policycheck.tools/api/clause-registry

if (result.flags.includes("binding_arbitration")) {
  // abort purchase or ask human for confirmation
}

curl -X POST https://policycheck.tools/api/v1/signed-assessment \
  -H "Content-Type: application/json" \
  -d '{"seller_url": "https://amazon.com"}'

{
  "signed_assessment": {
    "version": "1.0",
    "provider": "policycheck.tools",
    "assessment_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-02-22T10:00:00.000Z",
    "expires_at": "2026-02-22T10:05:00.000Z",
    "seller": { "domain": "amazon.com", "url": "https://amazon.com" },
    "flags": ["return_shipping_fee"],
    "risk_factors_summary": { "returns": 1 },
    "risk_score": 0.5,
    "risk_level": "low",
    "buyer_protection_score": 95,
    "buyer_protection_rating": "A+",
    "risk_factors": [...],
    "positives": [...],
    "analysis_status": "complete",
    "confidence": "high"
  },
  "signature": "base64url-ed25519-signature",
  "signed_payload_hash": "sha256:abc123...",
  "verification_url": "https://policycheck.tools/api/v1/verify",
  "jwks_url": "https://policycheck.tools/.well-known/jwks.json"
}

curl -X POST https://policycheck.tools/api/v1/verify \
  -H "Content-Type: application/json" \
  -d '{"signed_assessment": {...}, "signature": "..."}'

// Valid
{ "valid": true, "assessment_id": "...", "seller_domain": "amazon.com",
  "expires_at": "2026-02-22T10:05:00.000Z", "verified_at": "2026-02-22T10:01:00.000Z" }

// Expired or invalid
{ "valid": false, "reason": "Assessment has expired" }

{
  "keys": [{
    "kty": "OKP",
    "crv": "Ed25519",
    "use": "sig",
    "kid": "policycheck-1",
    "x": "base64url-encoded-public-key"
  }]
}

// 1. Get signed assessment
const result = await fetch("https://policycheck.tools/api/v1/signed-assessment", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: sellerUrl }),
}).then(r => r.json());

// 2. Present at checkout alongside agent identity
const checkoutPayload = {
  agent_identity: myAgentToken,
  seller_assessment: result.signed_assessment,
  seller_assessment_signature: result.signature,
  seller_assessment_jwks: result.jwks_url,
};

// 3. Merchant/payment processor can verify independently
const verification = await fetch(result.verification_url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    signed_assessment: result.signed_assessment,
    signature: result.signature,
  }),
}).then(r => r.json());
// { valid: true, assessment_id: "...", seller_domain: "amazon.com" }

const result = await fetch("https://policycheck.tools/api/check", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: sellerUrl }),
}).then(r => r.json());

if (result.analysis_status === "no_content") {
  // Can't analyze — ask human or try browser-based approach
  return askHuman(`Could not analyze ${sellerUrl}. Proceed anyway?`);
}

if (result.risk_level === "critical") {
  return abort("Seller has critical risk indicators");
}

proceed();

const MIN_SCORE = 70;

if (result.buyer_protection_score === null) {
  return askHuman("Unable to verify seller policies.");
}

if (result.buyer_protection_score >= MIN_SCORE) {
  proceed();  // score 85 → auto-approve
} else {
  askHuman(`Buyer protection score is ${result.buyer_protection_score}/100.`);
}

const DEALBREAKERS = ["no_refund", "no_returns", "hidden_fees"];

const matched = result.flags.filter(f => DEALBREAKERS.includes(f));
if (matched.length > 0) {
  abort(`Dealbreaker policies found: ${matched.join(", ")}`);
} else {
  proceed();
}