CommonVerification

Verifies a corporate account by matching the IBAN with the provided Company Registration (CR) or Unified National Number (UNN) and combines it with Beneficiary Verification.

Unique resource name : av.v2.account_verification_pro.corporate

Important!:

  • The IBAN must be a valid KSA IBAN.
  • The CR or UNN must be valid 10-digit numbers.
  • The beneficiaryName will be verified against the account holder name.
post/api/v2.0/av/CommonVerification/Corporate

Request

  • Base URL: https://sandbox.sparefinancial.sa
  • URL: https://sandbox.sparefinancial.sa/api/v2.0/av/CommonVerification/Corporate
  • Auth: API key in header Authorization

Request body

beneficiaryNamestring nullable

Name of the beneficiary to verify or pay.

ibanstring required

Account IBAN.

unnstring nullable

Company or entity registration identifier.

companyRegistrationNumberstring nullable

Company registration number.

Example request

{
  "iban": "SA0380000000608010167519"
}

Response

Verification was successful. The response includes the verification details for both the corporate ID and beneficiary.

error'INVALID_DATA' | 'ACCOUNT_VERIFICATION_FAILED' | 'SERVER_ERROR' | 'SUBSCRIPTION_EXPIRED'
errorDescriptionobject nullable

Example response

{
  "data": {
    "executionDate": "2025-01-01T00:00:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.