---
title: "Submit a new verification of payee"
method: POST
path: "/v1/verifications_of_payee"
tags: ["Verification of Payee"]
---

# Submit a new verification of payee

`POST /v1/verifications_of_payee`

Create a new verification of payee to validate if the provided name matches the account holder of the given IBAN.

## Request body

- VerificationOfPayeeRequest
  - `iban` string, required — The International Bank Account Number (IBAN) of the payee
  - `name` string, required — The name of the payee to verify

## Response `201`

Verification request successfully submitted

- VerificationOfPayeeResponse
  - `id` string, required — Solaris UID for the verification of payee
  - `payee` object, required — The payee information that was verified
    - `iban` string, required — The IBAN of the payee
    - `name` string, required — The name of the payee
  - `result` object, required — The result of the verification of payee
    - `status` 'MATCH' | 'NO_MATCH' | 'CLOSE_MATCH' | 'VERIFICATION_NOT_POSSIBLE' | 'VERIFICATION_NOT_SUPPORTED', required — The status of the verification of payee
    - `suggested_name` string — Suggested correct name when there is a close match but not exact
  - `used_for` object — The process the verification was used for. Will be present only if verification was already used for a process (e.g. SEPA_CREDIT_TRANSFER).
    - `type` 'SCT' | 'SCT_INSTANT' | 'SCHEDULED_SCT' | 'SCHEDULED_SCT_INSTANT' | 'BATCH_SCT' | 'BATCH_SCT_INSTANT' — The type of process the verification was used for.
    - `id` string — The unique identifier of the process (e.g. transaction identifier)
    - `timestamp` string, date-time — The timestamp when the verification was used
  - `created_at` string, date-time, required — The timestamp when the verification was created
  - `expires_at` string, date-time, required — The timestamp when the verification expires

## Other responses

- `400` — An error occurred on the client side.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/sepa-transfers.md) · [All operations](https://skmtc.net/solarisgroup/apis/sepa-transfers/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/sepa-transfers/revisions/f1fef352d976/schema)