# x402trustlayer.xyz Mandate Verify

> x402trustlayer.xyz Mandate Verify is a paid API for AI agents from x402trustlayer.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-20).

Verifies the status of a payment mandate across supported blockchain chains, returning validity, scope, violations, and confidence score.

## Facts

- Endpoint: POST https://x402trustlayer.xyz/api/mandate/verify?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402trustlayer-xyz-d2540c37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cjkLdavKo4P_yM0_wrWR0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402trustlayer-xyz-d2540c37 -d '<json body>'
```

Example prompt: Can you verify whether mandate abc123 is valid, allowed, and within scope on the trust layer — I need to know if there are any violations and what the confidence score is before I proceed with the payment?

## When to prefer this

Use this endpoint when you need to verify the current status, validity, scope, and compliance of a specific payment mandate across supported blockchain chains before executing or authorizing a transaction. Prefer this over generic identity or escrow endpoints when the specific concern is mandate-level compliance and violation detection with a confidence score.

## Known failure modes

- Invalid or unknown mandateId returns an error or ok:false with reason explaining the failure
- Unsupported chain results in scope validation failure
- Mandate expired or revoked returns valid:false
- Payment not confirmed results in verification being denied
- Malformed input schema returns a 400-level error
- Network or chain RPC timeout may cause delayed or failed response

## How this service works

Verifies mandate status across supported chains after payment.

## Output

Returns a JSON object with: ok (boolean), valid (boolean), allowed (boolean), withinScope (boolean), reason (string explanation), violations (array of violation objects), mandateId (string), proposed transaction details (amountUsdc, merchant, category, rail), confidence score (number), and an array of checks_passed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ok",
      "allowed",
      "valid",
      "withinScope",
      "reason",
      "violations",
      "mandateId",
      "proposed",
      "confidence",
      "checks_passed"
     ],
     "properties": {
      "ok": {
       "type": "boolean"
      },
      "valid": {
       "type": "boolean"
      },
      "reason": {
       "type": "string"
      },
      "allowed": {
       "type": "boolean"
      },
      "proposed": {
       "type": "object",
       "required": [
        "amountUsdc",
        "merchant",
        "category",
        "rail"
       ],
       "properties": {
        "rail": {
         "type": "string"
        },
        "category": {
         "type": "string"
        },
        "merchant": {
         "type": "string"
        },
        "amountUsdc": {
         "type": "number"
        }
       }
      },
      "mandateId": {
       "type": "string"
      },
      "confidence": {
       "type": "number"
      },
      "violations": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "withinScope": {
       "type": "boolean"
      },
      "checks_passed": {
       "type": "array",
       "items": {
        "type": "string"
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402trustlayer-xyz-d2540c37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402trustlayer.xyz](https://www.zero.xyz/host/x402trustlayer.xyz/llms.txt)
