---
title: "Payee Name-Match Score (VoP/CoP)"
method: POST
path: "/v1/tools/score_payee_name_match"
tags: ["TODO_TAGS_REVIEW"]
---

# Payee Name-Match Score (VoP/CoP)

`POST /v1/tools/score_payee_name_match`

## Request

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

Deterministic, versioned single-pair payee name-matching score for Verification-of-Payee / Confirmation-of-Payee evidence. Normalizes (diacritic stripping, legal-entity suffix removal), scores by integer Levenshtein edit distance against both a plain and a token-sorted form, and bands the result MATCH / CLOSE_MATCH / NO_MATCH against declared thresholds. algorithm_version is carried in the receipt so a score is reproducible evidence, not a black-box vendor output. Distinct from the batch aggregate analyser art-11: this scores one declared pair for downstream session-receipt binding.

**Tool URL:** https://ainumbers.co/chaingraph/art-376-score-payee-name-match.html
**AP2/Policy Mandate export:** yes

## Request body

- object
  - `account_name` string: type not evidenced by kernel source
  - `close_match_threshold` unknown, required
  - `match_threshold` unknown, required
  - `reference_name` string: type not evidenced by kernel source

## Response `200`

Successful tool execution result

- object
  - `algorithm_version` string
  - `close_match_threshold` integer
  - `compliance_flags` string[]
  - `entity_suffix_stripped` boolean
  - `match_band` string
  - `match_threshold` integer
  - `normalized_account_name` string
  - `normalized_reference_name` string
  - `score` integer
  - `transliteration_in_scope` boolean

---

[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)