AccountVerification

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

Unique resource name : av.v2.account_verification.corporate

Important!:

  • This endpoint is designed for clients who may not know which ID type to use and want to send all information for comprehensive validation.
  • The IBAN must be a valid KSA IBAN.
post/api/v2.0/av/AccountVerification/Corporate

Request

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

Request body

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 the IBAN and associated CR or UNN.

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.