Get Fraud Assessment
paybond_get_fraud_assessmentRead-only
Retrieve fraud assessment, review state, and signals for a tenant-scoped operator DID to inform spend workflow decisions.
Instructions
Use this when you need the read-only fraud assessment and review posture for one known tenant-scoped operator DID (review state, fraud signals, and compact fraud_assessment). Example: look up operator_did=did:web:vendor.example#booker-agent (optionally score_version=1.0) before deciding whether to continue a spend workflow for that operator. Do not use this for tenant-wide fraud backtesting metrics—call paybond_get_fraud_metrics instead—or for Harbor intent escrow detail—call paybond_get_intent. Idempotent read; returns null when no assessment exists for that operator.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operator_did | Yes | Tenant-scoped operator DID to assess. Must belong to the authenticated tenant; do not invent tenant identifiers. Examples: did:web:vendor.example#booker-agent, did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK. | |
| score_version | No | Optional Signal score model version to query. Omit to use the gateway default current model. Example: 1.0. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tenant_id | No | Tenant echoed by the gateway for the authenticated API key (example: tenant-a). | |
| operator_did | No | Operator DID echoed from the assessment response (example: did:web:vendor.example#booker-agent). | |
| fraud_assessment | No | Compact fraud assessment for the operator (level, severity, signal counts, summary). Example shape: {"level":"high","highest_severity":"high","signal_count":1,"summary":"level=high"}. |