CommercialRegistration

Retrieves detailed commercial registration information for the specified unified number.

Unique resource name : av.v2.commercial_registration.information

Important!:

  • Requires a valid Saudi Arabia Unified National Number (UNN) to successfully retrieve the information.
  • The UNN must meet the validation criteria for Saudi Arabia.
get/api/v2.0/av/CommercialRegistration/Information

Request

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

Query parameters

unifiedNationalNumberstring required

The unique Unified National Number (UNN) to fetch the associated commercial registration information. Ensure that the UNN is valid and formatted according to Saudi Arabia's standards.

language'ar' | 'en'

Language, by default is arabic

Response

Returns the commercial registration information for the provided UNN.

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

Example response

{
  "data": {
    "information": {
      "issueDateGregorian": "2025-01-01T00:00:00Z",
      "issueDateHijri": "2025-01-01T00:00:00Z"
    }
  }
}

Changes

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