---
title: "KYA Credential x x402 Payload Scope Verifier"
method: POST
path: "/v1/tools/verify_kya_x402_scope"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# KYA Credential x x402 Payload Scope Verifier

`POST /v1/tools/verify_kya_x402_scope`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/verify_kya_x402_scope`
- Auth: none declared

Cross-checks a declared KYA (Know Your Agent) credential's scope against a declared x402 PaymentPayload: amount vs the credential's spend cap, network/asset vs its allowed set, payee vs its merchant allowlist, validity window vs the payload's timestamps, and scope-string coverage of the payment scheme. Returns findings[] and a verdict of IN_SCOPE, OUT_OF_SCOPE, or INDETERMINATE (when the credential omits a claim the payload requires -- never guessed). Verify-only: never fetches either input, never contacts Skyfire or a facilitator, performs no signature verification, and never initiates or settles an x402 payment.

**Tool URL:** https://ainumbers.co/chaingraph/art-565-kya-x402-scope-verifier.html

## Request body

- object
  - `kya_credential` unknown, required
  - `x402_payload` unknown, required

## Response `200`

Successful tool execution result

- object
  - `credential_audience` string
  - `credential_seller_service_id` string
  - `credential_subject` string
  - `findings` object[]
    - `check` string
    - `detail` string
    - `pass` boolean
  - `indeterminate_reasons` unknown[]
    - unknown
  - `kya_claim_basis` string
  - `note` string
  - `payload_network` string
  - `payload_scheme` string
  - `rationale` string[]
  - `rejected_inputs` unknown[]
    - unknown
  - `verdict` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)