---
title: "Reject Beneficiary"
method: POST
path: "/users/{userId}/beneficiaries/{beneficiaryId}/reject"
tags: ["User Beneficiaries"]
---

# Reject Beneficiary

`POST /users/{userId}/beneficiaries/{beneficiaryId}/reject`

## Request

- Base URL: `https://api.yapily.com`
- URL: `https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}/reject`
- Auth: HTTP basic

End-user has rejected the beneficiary details

## Path parameters

- `beneficiaryId` string, uuid, required: Beneficiary Id
- `userId` string, uuid, required

## Headers

- `sub-application` string, uuid

## Request body

- UserBeneficiaryValidationRequest: Beneficiary request with the details of the VoP result.
  - `name` string, required: name of the beneficiary
  - `match` UserBeneficiaryMatch: Details of the match given by the institution.
    - `status` 'FULL_MATCH' | 'CLOSE_MATCH' | 'NO_MATCH' | 'EXEMPTED' | 'VERIFICATION_CHECK_NOT_POSSIBLE'
    - `closeMatchName` string: the name returned by the institution, in a case of CLOSE_MATCH
  - `accountIdentifier` AccountIdentifier, required: Account's details.
    - `type` 'IBAN', required
    - `identification` string, required: Account's IBAN

## Response `200`

OK.

- UserBeneficiaryResponse: The user beneficiary response.
  - `meta` ResponseMeta
    - `tracingId` string
  - `data` UserBeneficiaryData: Beneficiary data response.
    - `beneficiaryId` string, uuid: id of the beneficiary
    - `status` 'PENDING' | 'VERIFIED' | 'REJECTED': Status of the beneficiary check.
    - `details` object: Beneficiary response with the details of the VoP result.
      - `name` string, required: name of the beneficiary
      - `match` UserBeneficiaryMatch: Details of the match given by the institution.
        - `status` 'FULL_MATCH' | 'CLOSE_MATCH' | 'NO_MATCH' | 'EXEMPTED' | 'VERIFICATION_CHECK_NOT_POSSIBLE'
        - `closeMatchName` string: the name returned by the institution, in a case of CLOSE_MATCH
      - `accountIdentifier` AccountIdentifier, required: Account's details.
        - `type` 'IBAN', required
        - `identification` string, required: Account's IBAN

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal error

---

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