Oman KYB Verification

Overview

The Oman KYB Fetch API allows users to retrieve detailed business information registered in Oman. This API facilitates business verification and due diligence processes by providing comprehensive company profiles.

Use Cases

Enhanced Due Diligence:

Verify business legitimacy and compliance with local regulations in Oman before forming partnerships or proceeding with transactions.

Risk Management:

Assess potential risks associated with business partnerships by accessing detailed company profiles and ownership structures.

Regulatory Compliance:

Ensure adherence to anti-money laundering (AML) and counter-financing of terrorism (CFT) regulations by verifying the operational and legal status of businesses in Qatar.

Supplier Verification:

Confirm the authenticity and operational status of suppliers to maintain supply chain integrity and prevent fraud.

API Details

Request Body

curl --location 'https://api.signzy.ae/api/v3/uae/om-kyb' \
--header 'Authorization: <AUTHORIZATION>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "crNumber": "1234039",
    "commercialName": "Sand"
}'

Request Body Parameters

Parameter	Type	Description	Required
crNumber	String	This typically represents the company registration number or a unique identifier for the business in the system.	At least one of crNumber or commercialName is required.
commercialName	String	This is the commercial or trade name of the company.	At least one of crNumber or commercialName is required.

Response Body

{
    "result": [
        {
            "crNumber": "<CR_NUMBER>",
            "name": {
                "textEn": "<ENGLISH_NAME>",
                "textAr": "<ARABIC_NAME>"
            },
            "legalType": "<LEGAL_TYPE>",
            "registrationStatus": "<REGISTRATION_STATUS>",
            "registrationDate": "<REGISTRATION_DATE>",
            "expiryDate": "<EXPIRY_DATE>",
            "capital": {
                "cashCapital": "<CASH_CAPITAL>",
                "assetCapital": "<ASSET_CAPITAL>",
                "shareValue": "<SHARE_VALUE>",
                "capitalPaymentCheckRequired": <CAPITAL_PAYMENT_CHECK_REQUIRED>,
                "totalCapital": "<TOTAL_CAPITAL>",
                "shareCount": "<SHARE_COUNT>"
            },
            "subjectToForeignInvestment": <SUBJECT_TO_FOREIGN_INVESTMENT>,
            "fiscalInfo": {
                "establishmentDate": "<ESTABLISHMENT_DATE>",
                "establishmentDuration": <ESTABLISHMENT_DURATION>,
                "contractEndDate": <CONTRACT_END_DATE>,
                "firstFiscalYearEnd": "<FIRST_FISCAL_YEAR_END>",
                "fiscalYearEndDay": "<FISCAL_YEAR_END_DAY>",
                "fiscalYearEndMonth": "<FISCAL_YEAR_END_MONTH>"
            },
            "address": {
                "businessLocation": {
                    "id": "<LOCATION_ID>",
                    "isoCode": "<ISO_CODE>",
                    "parent": {
                        "id": "<PARENT_ID>",
                        "isoCode": "<PARENT_ISO_CODE>",
                        "parent": {
                            "id": "<GRANDPARENT_ID>",
                            "isoCode": "<GRANDPARENT_ISO_CODE>",
                            "parent": null,
                            "level": 1,
                            "name": {
                                "textEn": "<PARENT_NAME_EN>",
                                "textAr": "<PARENT_NAME_AR>"
                            },
                            "active": <ACTIVE>,
                            "specialZone": <SPECIAL_ZONE>,
                            "industrialZone": <INDUSTRIAL_ZONE>,
                            "descendants": []
                        },
                        "level": 2,
                        "name": {
                            "textEn": "<LEVEL2_NAME_EN>",
                            "textAr": "<LEVEL2_NAME_AR>"
                        },
                        "active": <ACTIVE>,
                        "specialZone": <SPECIAL_ZONE>,
                        "industrialZone": <INDUSTRIAL_ZONE>,
                        "descendants": []
                    },
                    "level": 3,
                    "name": {
                        "textEn": "<LEVEL3_NAME_EN>",
                        "textAr": "<LEVEL3_NAME_AR>"
                    },
                    "active": <ACTIVE>,
                    "specialZone": <SPECIAL_ZONE>,
                    "industrialZone": <INDUSTRIAL_ZONE>,
                    "descendants": []
                },
                "street": {
                    "textEn": "<STREET_EN>",
                    "textAr": "<STREET_AR>"
                },
                "blockNumber": <BLOCK_NUMBER>,
                "wayNumber": <WAY_NUMBER>,
                "unitNumber": <UNIT_NUMBER>,
                "poBox": "<PO_BOX>",
                "buildingNumber": "<BUILDING_NUMBER>",
                "postalCode": "<POSTAL_CODE>",
                "latitude": <LATITUDE>,
                "longitude": <LONGITUDE>
            },
            "contactDetails": {
                "phone": {
                    "number": "<PHONE_NUMBER>",
                    "countryIsoCode": "<COUNTRY_ISO_CODE>",
                    "countryPhoneCode": "<COUNTRY_PHONE_CODE>"
                },
                "email": "<EMAIL>",
                "landLine": {
                    "number": <LANDLINE_NUMBER>,
                    "countryIsoCode": <LANDLINE_COUNTRY_ISO_CODE>,
                    "countryPhoneCode": <LANDLINE_COUNTRY_PHONE_CODE>
                },
                "notificationChannel": <NOTIFICATION_CHANNEL>,
                "language": <LANGUAGE>
            },
            "activities": [
                {
                    "id": "<ACTIVITY_ID>",
                    "isicCode": "<ISIC_CODE>",
                    "name": {
                        "textEn": "<ACTIVITY_NAME_EN>",
                        "textAr": "<ACTIVITY_NAME_AR>"
                    },
                    "eligibleForECommerce": <ELIGIBLE_FOR_E_COMMERCE>,
                    "obsolete": <OBSOLETE>,
                    "mainActivity": <MAIN_ACTIVITY>
                }
            ],
            "investors": [
                {
                    "investorId": "<INVESTOR_ID>",
                    "name": {
                        "textEn": "<INVESTOR_NAME_EN>",
                        "textAr": "<INVESTOR_NAME_AR>"
                    },
                    "shareCount": "<SHARE_COUNT>",
                    "sharePercentage": "<SHARE_PERCENTAGE>",
                    "designation": "<INVESTOR_DESIGNATION>",
                    "country": {
                        "isoCode": "<COUNTRY_ISO_CODE>",
                        "isoA3Code": "<COUNTRY_ISO_A3_CODE>",
                        "isoA2Code": "<COUNTRY_ISO_A2_CODE>",
                        "phoneCode": "<COUNTRY_PHONE_CODE>",
                        "name": {
                            "textEn": "<COUNTRY_NAME_EN>",
                            "textAr": "<COUNTRY_NAME_AR>"
                        },
                        "isoContinentCode": "<ISO_CONTINENT_CODE>",
                        "regionCode": "<REGION_CODE>",
                        "arabCode": "<ARAB_CODE>",
                        "local": <LOCAL>,
                        "active": <ACTIVE>,
                        "privileged": <PRIVILEGED>,
                        "arab": <ARAB>,
                        "efta": <EFTA>
                    },
                    "gender": "<GENDER>",
                    "dateOfBirth": <DATE_OF_BIRTH>
                }
            ],
            "signatories": [
                {
                    "signatoryId": "<SIGNATORY_ID>",
                    "name": {
                        "textEn": "<SIGNATORY_NAME_EN>",
                        "textAr": "<SIGNATORY_NAME_AR>"
                    },
                    "signatureType": "<SIGNATURE_TYPE>",
                    "designation": "<DESIGNATION>",
                    "limit": <LIMIT>,
                    "hasFullAuthority": <HAS_FULL_AUTHORITY>,
                    "dateOfBirth": "<SIGNATORY_DATE_OF_BIRTH>",
                    "isTaxRepresentative": <IS_TAX_REPRESENTATIVE>
                }
            ],
            "auditors": [],
            "mainActivity": {
                "id": "<ACTIVITY_ID>",
                "isicCode": "<ISIC_CODE>",
                "name": {
                    "textEn": "<ACTIVITY_NAME_EN>",
                    "textAr": "<ACTIVITY_NAME_AR>"
                },
                "eligibleForECommerce": <ELIGIBLE_FOR_E_COMMERCE>,
                "obsolete": <OBSOLETE>,
                "mainActivity": <MAIN_ACTIVITY>
            }
        }
    ]
}

Response Body Parameters

Field	Type	Description
crNumber	String	The company registration number.
name.textEn	String	The English name of the business.
name.textAr	String	The Arabic name of the business.
legalType	String	The legal type of the business (e.g., LLC).
registrationStatus	String	The registration status of the business (e.g., ACTIVE, INACTIVE).
registrationDate	String	The registration date of the business in the format YYYY-MM-DD.
expiryDate	String	The expiry date of the business registration in the format YYYY-MM-DD.
capital.cashCapital	Integer	The cash capital of the business.
capital.assetCapital	Integer	The asset capital of the business.
capital.shareValue	Integer	The value of each share.
capital.capitalPaymentCheckRequired	Boolean	Indicates whether capital payment verification is required.
capital.totalCapital	Integer	The total capital of the business.
capital.shareCount	Integer	The total number of shares in the business.
subjectToForeignInvestment	Boolean	Indicates whether the business is subject to foreign investment.
fiscalInfo.establishmentDate	String	The date the business was established.
fiscalInfo.establishmentDuration	String	The duration of the business establishment.
fiscalInfo.contractEndDate	String	The end date of the business contract, if applicable.
fiscalInfo.firstFiscalYearEnd	String	The end date of the business’s first fiscal year.
fiscalInfo.fiscalYearEndDay	Integer	The day of the fiscal year-end.
fiscalInfo.fiscalYearEndMonth	Integer	The month of the fiscal year-end.
address.businessLocation.id	Integer	The unique identifier of the business location.
address.businessLocation.isoCode	String	The ISO code representing the location.
address.businessLocation.parent.id	Integer	The ID of the parent location in the hierarchy.
address.businessLocation.parent.isoCode	String	The ISO code of the parent location.
address.businessLocation.parent.name.textEn	String	The English name of the parent location.
address.businessLocation.parent.name.textAr	String	The Arabic name of the parent location.
address.businessLocation.level	Integer	The hierarchical level of the location.
address.street.textEn	String	The street name in English.
address.street.textAr	String	The street name in Arabic.
address.poBox	Integer	The PO Box of the business.
address.buildingNumber	String	The building number of the business location.
address.postalCode	String	The postal code of the business location.
address.latitude	Float	The latitude of the business location.
address.longitude	Float	The longitude of the business location.
contactDetails.phone.number	String	The phone number of the business contact.
contactDetails.phone.countryIsoCode	String	The ISO country code for the phone number.
contactDetails.phone.countryPhoneCode	String	The phone code for the country.
contactDetails.email	String	The email address of the business.
contactDetails.landLine.number	String	The landline number, if available.
contactDetails.language	String	The preferred language of communication for the business.
activities.id	Integer	The ID of the activity.
activities.isicCode	String	The ISIC (International Standard Industrial Classification) code for the activity.
activities.name.textEn	String	The English name of the activity.
activities.name.textAr	String	The Arabic name of the activity.
investors.investorId	Integer	The ID of the investor.
investors.name.textEn	String	The English name of the investor.
investors.name.textAr	String	The Arabic name of the investor.
investors.shareCount	Integer	The number of shares owned by the investor.
investors.sharePercentage	Integer	The percentage of shares owned by the investor.
investors.designation	String	The designation of the investor (e.g., PARTNER).
investors.country.isoCode	String	The ISO country code of the investor.
investors.country.name.textEn	String	The English name of the investor’s country.
investors.gender	String	The gender of the investor (e.g., MALE, FEMALE).
signatories.signatoryId	Integer	The ID of the signatory.
signatories.name.textEn	String	The English name of the signatory.
signatories.name.textAr	String	The Arabic name of the signatory.
signatories.signatureType	String	The type of signature (e.g., SOLE).
signatories.designation	String	The designation of the signatory (e.g., AUTH_PRT).
signatories.hasFullAuthority	Boolean	Indicates whether the signatory has full authority.
signatories.dateOfBirth	String	The date of birth of the signatory.
signatories.isTaxRepresentative	Boolean	Indicates if the signatory is a tax representative.
auditors	Array	A list of auditors, which is empty in this case.
mainActivity.id	Integer	The ID of the main activity.
mainActivity.isicCode	String	The ISIC code for the main activity.
mainActivity.name.textEn	String	The English name of the main activity.
mainActivity.name.textAr	String	The Arabic name of the main activity.

Error Code and Response Mapping

{
  "error": {
     "name": "error",
     "message": "Invalid authentication credentials",
     "status": 401,
     "reason": "AUTHENTICATION_ERROR",
     "type": "Bad Request",
     "statusCode": 401
  }
}

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	number	Status code representing the error scenario.

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!