---
title: "Validate beneficiary details"
method: POST
path: "/banks/{customerId}/validationofbeneficiary"
tags: ["Bank Resource"]
---

# Validate beneficiary details

`POST /banks/{customerId}/validationofbeneficiary`

## Path parameters

- `customerId` string, required

## Request body

- BeneficiaryValidationRequestData
  - `currencyCode` string, required — Currency code for the validation
  - `beneficiary` ValidationBeneficiaryData, required
    - `name` string, required — Beneficiary name
    - `countryCode` string, required — Beneficiary country code
  - `bankAccount` ValidationBankAccountData, required
    - `iban` string, required — International Bank Account Number

## Response `200`

OK

- BeneficiaryValidationResultData
  - `beneficiary` ValidationResultBeneficiaryData
    - `name` string — Validated beneficiary name
    - `iban` string — Validated IBAN
    - `matchScore` string — Match score for validation
    - `matchType` string — Type of match (e.g., MTCH)
    - `matchDescription` string — Description of the match result
    - `validationMessage` string — Validation message with instructions
    - `disclaimer` string

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/convera/apis/payments-api.md) · [All operations](https://skmtc.net/convera/apis/payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convera/payments-api/revisions/ff82548143cf/schema)