SpareSpare Docs
GuidesAPI Reference

Beneficiary Verification

Confirm the registered owner of a UAE IBAN before initiating a payment.

POST
/verifications/beneficiary
Authorization
Header

Regulatory jurisdiction the request routes to (e.g. `UAE`, `KSA`, `MAIN`). Match it to the market you're integrating.

Body
*object

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/verifications/beneficiary" \  -H "x-tenant: KSA" \  -H "Content-Type: application/json" \  -d '{    "iban": "string"  }'
{  "data": {    "accountIdentifier": "string",    "accountStatus": "string",    "bank": {      "arabicName": "string",      "bankCode": "string",      "englishName": "string",      "swiftCode": "string"    },    "beneficiaryName": "string",    "errorDescription": "string",    "executionDate": "string",    "inputBeneficiaryName": "string",    "requestId": "string",    "result": "MATCH"  },  "error": "string",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  }}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "string",  "details": {},  "message": "string"}
{  "code": "not_found",  "details": {},  "message": "string"}