Create External Beneficiary

Testing Env

https://api.uat.sokin.com

POST

/beneficiaries/external-beneficiary

Create an external beneficiary.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Successful Response

Body

🟠400

🟠401

🟠403

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.uat.sokin.com/beneficiaries/external-beneficiary' \
--header 'x-api-version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency": "str",
    "country": "st",
    "type": "Individual",
    "transactionType": "string",
    "beneficiaryCountry": "string",
    "routingNumber": "string",
    "beneficiaryName": "string",
    "financialInstitution": "string",
    "financialInstitutionBranch": "string",
    "email": "string",
    "mobileNumber": "strings",
    "accountName": "string",
    "accountType": "IBAN",
    "accountNumber": "string",
    "identifierType": "BIC/SWIFT",
    "identifierValue": "string",
    "houseBuildingNumber": "string",
    "streetName": "string",
    "postalCode": "string",
    "city": "string",
    "stateOrProvince": "string",
    "bankId": "string",
    "accountFirstName": "string",
    "accountLastName": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "addressLine3": "string",
    "iban": "string"
}'

Response Example

201 - Example 1

{
    "message": "string",
    "data": {
        "beneficiaryId": "string"
    }
}

Modified at 2025-12-17 17:45:30

Get Beneficiary Fields

Get Beneficiary List