Sign in

v1

latestOpenAPI 3.0.02026-07-145016.7 KB
Recipients

Update Recipient

Allows a user to update recipient details.<br><br>

patch/accounts/recipients/{recipientIdentifier}

Path parameters

recipientIdentifierstring required

Recipient Identifier

Headers

Content-Typestring
Authorizationstring

Request body

recipient_type'individual' | 'business'

The type of the recipient.

emailstring

Recipient's email.

business_namestring

Name of the recipient when recipient_type is business.

first_namestring

First name of the recipient when recipient_type is individual.

last_namestring

Last name of the recipient when recipient_type is individual.

relationship'business_associate_partner' | 'customer' | 'employee' | 'branch_representative_office' | 'subsidiary_company' | 'holding_company' | 'supplier' | 'creditor' | 'debtor' | 'franchisee_franchisor' | 'others'

Recipient's relationship

reasonstring

Reason for the payouts issued to this recipient.

eid_numberstring

Recipient's Emirates ID number.

recipient_metaobject

Example request

{
  "recipient_type": "individual",
  "first_name": "first name",
  "last_name": "last name",
  "relationship": "others",
  "reason": "reason",
  "bank": {
    "iban": "AE080200000123223333121",
    "country": "AE"
  }
}

Response

Successful response

identifierstring
recipient_typestring
namestring
relationshipstring
emailstring
eid_numberstring
reasonstring
created_atstring
recipient_metaobject

Example response

{
  "identifier": "REP-D8B07FB8C7",
  "name": "first name last name",
  "recipient_type": "individual",
  "relationship": "others",
  "reason": "reason",
  "email": null,
  "eid_number": null,
  "address": null,
  "bank": {
    "iban": "AE080200000123223333121",
    "country": "AE",
    "name": null,
    "account_number": null,
    "address": null,
    "city": null,
    "bic_code": null
  },
  "created_at": "19/02/2024",
  "recipient_meta": {}
}