---
title: "Complete beneficiary name matching check"
method: POST
path: "/entities/{entityDID}/tx/{transferId}/checks/beneficiary-name-matching"
tags: ["Transfer Checks"]
---

# Complete beneficiary name matching check

`POST /entities/{entityDID}/tx/{transferId}/checks/beneficiary-name-matching`

## Request

- Base URL: `https://api.eu1.notabene.id`
- URL: `https://api.eu1.notabene.id/entities/{entityDID}/tx/{transferId}/checks/beneficiary-name-matching`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/notabene/apis/notabene-api/docs/entities/:entityDID/tx/:transferId/checks/beneficiary-name-matching/post.ts> (a function with typed inputs; its response is checked against the schema)

Marks the beneficiary name matching check as complete for the specified transfer. This endpoint is called after the entity has verified that the beneficiary name matches.

## Path parameters

- `entityDID` string, did, required: Decentralized Identifier (DID)
- `transferId` string, uuid, required

## Response `200`

Beneficiary name matching check completed

- object
  - `id` string, uuid, required
  - `transferId` string, uuid, required
  - `entityDid` string, required
  - `type` 'REQUIRE_BENEFICIARY_NAME_MATCHING' | 'REQUIRE_INTERNAL_CHECKS', required
  - `status` 'PENDING' | 'COMPLETE', required
  - `policyData` object, nullable
    - `confirmedBy` string, required
    - `confirmedAt` string, date-time, required
  - `createdAt` union, required
    - string
    - string, date-time
  - `updatedAt` union, required
    - string
    - string, date-time

## Other responses

- `400`: Bad Request - The server could not process the request due to a client error.
- `401`: Unauthorized - Authentication information is missing or invalid.
- `403`: Forbidden - The server understood the request but refuses to authorize it.
- `404`: Not Found - The requested resource could not be found.
- `409`: Conflict - The request could not be completed due to a conflict with the current state of the resource.
- `500`: Internal Server Error - An unexpected condition was encountered on the server.

---

[API](https://skmtc.dev/notabene/apis/notabene-api.md) - [All operations](https://skmtc.dev/notabene/apis/notabene-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notabene/apis/notabene-api/revisions/70056745a433?raw)