Get Outbound Beneficiary by Id
Get Outbound Bank Beneficiary by Id
GET {{Environment_URL}}/customers/v1/partner/legal/:cnpj/beneficiary/:accountId
This endpoint is used to get a outbound bank beneficiary.
Headers
Name
Value
Description
Authorization
Bearer <token>
Bearer Token obtained via sign-in
Path Params
Key
Description
Required
Data Type
Example
cnpj
cnpj in format 10111101000101
true
String
10111101000101
accountId
The unique identifier of the bank account to be deleted. This ID is returned in the account creation response
true
String
6887bd8a05fc6408d37076a1
Response
{
"id": "68c2dfa3842cbcd66603c53c",
"fullName": "{{$randomFullName}}",
"email": "{{$randomExampleEmail}}",
"phone": "+51123456789",
"cpf": "98765432100",
"currency": "PEN",
"address": {
"country": "PE",
"state": "LMA",
"city": "Lima",
"neighborhood": "Miraflores",
"street": "Avenida Larco",
"number": 890,
"complement": "Oficina 501",
"zipCode": "15074",
"default": true,
"nickname": "Lima Office",
"id": "68c2dfa3842cbcd66603c53d"
},
"type": "OUTBOUND",
"studyDocuments": [
{
"key": "dni",
"id": "68c2dfa3842cbcd66603c53e"
}
],
"subType": "PERSON_TRANSFER",
"personType": "PHYSICAL",
"account": {
"name": "{{$randomFullName}}",
"type": "OUTBOUND",
"beneficiaryDocument": {
"beneficiaryDocType": "DNI",
"value": "12345678"
},
"bankName": "Banco de Crédito del Perú",
"bankBranch": "0001",
"bankCode": "002",
"bankCountry": "PER",
"bankAccountType": "CH",
"number": "00112345678901234567",
"code": {
"option": "SWIFT_BIC",
"value": "BCPLPEPL"
},
"currency": "PEN",
"paymentMethod": "BANK_ACCOUNT",
"id": "68c2dfa3842cbcd66603c53f",
"createdAt": "2025-09-11T14:41:39.776Z"
}
}