latestOpenAPI 3.0.12026-08-108798310.5 KB

fa1a72b9ecec

Payees

Get a specific account holder payee

get/api/v2/payees/{payeeUid}

Path parameters

payeeUidstring uuid required
Example:aaaaaaaa-aaaa-4aaa-aaaa-aaaaaaaaaaaa

Unique identifier of the payee

Response

Successful operation

payeeUidstring uuid required

The uid of this payee

payeeNamestring required

Name

phoneNumberstring

Phone number

payeeType'BUSINESS' | 'INDIVIDUAL' required

INDIVIDUAL

firstNamestring

First name

middleNamestring

Middle name

lastNamestring

Last name

businessNamestring

Business name

dateOfBirthstring date

Date of birth

Example response

{
  "payeeUid": "55665566-5566-5566-5566-556655665566",
  "payeeName": "Bob Bobbington",
  "phoneNumber": "+447700900123",
  "firstName": "Bob",
  "middleName": "Bobity",
  "lastName": "Bobbington",
  "businessName": "Trotters Independent Traders",
  "dateOfBirth": "1990-11-30",
  "accounts": [
    {
      "payeeAccountUid": "66776677-6677-6677-6677-667766776677",
      "payeeChannelType": "SETTLE_UP",
      "description": "Bob's business account",
      "defaultAccount": true,
      "countryCode": "GB",
      "accountIdentifier": "12345678",
      "bankIdentifier": "123456",
      "bankIdentifierType": "SORT_CODE"
    }
  ]
}