---
title: "Cross-Border Payment Prevalidation Readiness Scorer"
method: POST
path: "/v1/tools/prevalidation_readiness_scorer"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Cross-Border Payment Prevalidation Readiness Scorer

`POST /v1/tools/prevalidation_readiness_scorer`

## Request

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

Aggregate CBPR+ pre-validation readiness check for a single pacs.008 payment instruction. Combines IBAN mod-97 check (ISO 13616), BIC format (ISO 9362), LEI format (ISO 17442, presence and format only), UUIDv4 UETR, and PostalAddress24 structure (CBPR+ hybrid/fully-structured rules) into a single /ready boolean for STP gate use. Gate node for the cross-border-payment-prevalidation chain: ready=true means the instruction passes pre-validation; ready=false means remediation is required.

**Tool URL:** https://ainumbers.co/chaingraph/art-247-prevalidation-readiness-scorer.html

## Request body

- object
  - `address_building_number` unknown, required
  - `address_country` unknown, required
  - `address_lines` unknown[], required
    - unknown
  - `address_post_code` unknown, required
  - `address_street_name` unknown, required
  - `address_town_name` unknown, required
  - `bic` unknown, required
  - `iban` unknown, required
  - `lei` unknown, required
  - `uetr` unknown, required

## Response `200`

Successful tool execution result

- object
  - `cbpr_plus_deadline` string
  - `chain_gate_note` string
  - `check_details` object
    - `address` object
      - `error` string
      - `type` string
      - `valid` boolean
    - `bic` object
      - `error` string
      - `provided` boolean
      - `valid` boolean
    - `iban` object
      - `error` string
      - `provided` boolean
      - `valid` boolean
    - `lei` object
      - `error` string
      - `provided` boolean
      - `valid` boolean
    - `uetr` object
      - `error` string
      - `provided` boolean
      - `valid` boolean
  - `checks_passed` integer
  - `checks_total` integer
  - `pii_note` string
  - `readiness_pct` integer
  - `ready` boolean
  - `regulatory_basis` string
  - `remediation_actions` unknown[]
    - unknown
  - `table_source` string
  - `table_version` 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)
