---
title: "Verify contact"
method: POST
path: "/api/fma/v1/verify-contact"
tags: ["Managed Custody Mode"]
---

# Verify contact

`POST /api/fma/v1/verify-contact`

Create and validate a new payout recipient, returning the contactId, purposeId, and refId needed to submit the payout. Creditor name, street, city, and country must use Latin characters.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required
- `X-Ur-Id` string
- `X-External-User-Id` string

## Request body

- McVerifyContactRequest
  - `account` string, required — Recipient IBAN or account number.
  - `bankName` string, required — Recipient bank name.
  - `bic` string, required — Recipient bank BIC.
  - `purpose` integer, required — Payment purpose ID from the payment purposes list.
  - `reference` string, required — Payment reference.
  - `creditorInfo` McCreditorInfo — Recipient details, required when creating a new third-party contact. name, street, city, and country must use Latin characters.
    - `name` string, required
    - `street` string, required
    - `city` string, required
    - `zip` string, required
    - `country` string, required

## Response `200`

Standard envelope. Business errors return HTTP 200 with a non-zero code.

- McVerifyContactResponse — Standard UR OpenAPI response envelope. code 0 means success; a non-zero code is a business error described by message.
  - `code` integer, required — 0 on success; non-zero business error code.
  - `message` string, required — Human-readable explanation. May be empty on success.
  - `data` McVerifyContactData
    - `account` string — Recipient IBAN or account number echoed from the request.
    - `bankName` string
    - `bic` string
    - `purpose` integer
    - `reference` string
    - `clientPayoutRefParams` McPayoutRefParams
      - `contactId` string — Contact ID to use in the payout submission.
      - `purposeId` integer — Payment purpose ID.
      - `refId` string — Reference ID. Provide together with purposeId in the payout submission.

---

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