---
title: "Create Verification of Payee (VOP) request"
method: POST
path: "/verify-payee"
tags: ["Verification of Payee"]
---

# Create Verification of Payee (VOP) request

`POST /verify-payee`

This endpoint allows you to get information on the accuracy of the payee details the user is going to send a payment to.

## Request body

- VerificationofpayeeOutboundVopRequest — Verify Payee Request
  - `name` string, required — The name of the payee.
  - `iban` string, required — The IBAN of the payee.
  - `paymentAccountId` string, required — The bid of the account the payment will be initiated from.
  - `customerId` string — The bid of the customer that is making this request.

## Response `200`

Ok

- VerificationofpayeeOutboundVopResponse — Verify Payee Response
  - `id` string, required — Unique id of verify payee request.
  - `result` VerificationofpayeeOutboundVopResponseResult, required — Verify Payee Result
    - `code` 'MATCH' | 'NO_MATCH' | 'CLOSE_MATCH' | 'CHECK_NOT_POSSIBLE', required — The result of verify payee.
    - `matchedName` string — The actual name of the payee

## Other responses

- `400` — Validation Errors
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)