SpareSpare Docs
GuidesAPI Reference

Commercial Registration

Look up company registration and business details.

GET
/api/v2.0/av/CommercialRegistration/Information
Authorization
Query

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, by default is arabic

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2.0/av/CommercialRegistration/Information?unifiedNationalNumber=string"
{  "error": "INVALID_DATA",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "data": {    "requestId": "string",    "information": {      "name": "string",      "commercialRegistrationNumber": "string",      "langId": 0,      "companyDuration": 0,      "versionNumber": 0,      "commercialRegistrationCapital": 0,      "languageName": "string",      "commercialRegistrationNationalNumber": "string",      "isMain": true,      "issueDateGregorian": "string",      "issueDateHijri": "string",      "mainCommercialRegistryNationalNumber": "string",      "mainCommercialRegistryNumber": "string",      "inLiquidationProcess": true,      "hasEcommerce": true,      "headquarterCityId": 0,      "headquarterCityName": "string",      "isLicenseBased": true,      "licenseIssuerNationalNumber": "string",      "licenseIssuerName": "string",      "partnersNationalityId": 0,      "PartnersNationalityName": "string",      "entityType": {        "id": 0,        "name": "string",        "formName": "string",        "formId": 0,        "characters": [          {            "id": 0,            "name": "string"          }        ]      },      "status": {        "id": 0,        "name": "string",        "confirmationDate": {          "gregorian": "string",          "hijri": "string"        },        "reactivationDate": {          "gregorian": "string",          "hijri": "string"        },        "suspensionDate": {          "gregorian": "string",          "hijri": "string"        },        "deletionDate": {          "gregorian": "string",          "hijri": "string"        }      },      "contactInfo": {        "phoneNumber": "string",        "mobileNumber": "string",        "email": "string",        "websiteUrl": "string"      },      "commerce": {        "store": [          {            "authenticationPlatformUrl": "string",            "storeUrl": "string",            "storeActivities": [              {                "id": "string",                "name": "string"              }            ]          }        ]      },      "capital": {        "currencyId": 0,        "currencyName": "string",        "contributionCapital": {          "typeId": 0,          "inKindCapital": 0,          "typeName": "string",          "cashCapital": 0,          "contributionValue": 0,          "totalCashContribution": 0,          "totalInKindContribution": 0        },        "stockCapital": {          "typeId": 0,          "typeName": "string",          "cashCapital": 0,          "inKindCapital": 0,          "capital": 0,          "announcedCapital": 0,          "paidCapital": 0,          "stocks": [            {              "typeId": 0,              "typeName": "string",              "count": 0,              "value": 0,              "classReferenceID": 0,              "className": "string"            }          ]        }      },      "fiscalYear": {        "isFirst": true,        "calendarTypeId": 0,        "calendarTypeName": "string",        "endMonth": 0,        "endDay": 0,        "endYear": 0      },      "parties": [        {          "name": "string",          "typeId": 0,          "typeName": "string",          "crNumber": "string",          "licenseNo": "string",          "identity": {            "id": "string",            "typeId": 0,            "typeName": "string"          },          "partnership": [            {              "id": 0,              "name": "string"            }          ],          "partnerShare": {            "cashContributionCount": 0,            "inKindContributionCount": 0,            "totalContributionCount": 0          },          "nationality": {            "id": 0,            "name": "string"          }        }      ],      "management": {        "structureId": 0,        "structureName": "string",        "managers": [          {            "typeId": 0,            "name": "string",            "typeName": "string",            "isLicensed": true,            "nationality": {              "id": 0,              "name": "string"            },            "identity": {              "id": "string",              "typeId": 0,              "typeName": "string"            },            "positions": [              {                "id": 0,                "name": "string"              }            ]          }        ]      },      "activities": [        {          "id": "string",          "name": "string"        }      ]    },    "errorDescription": "string"  }}
{  "error": "INVALID_DATA",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "data": null}
{  "error": "INVALID_DATA",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "data": null}
{  "error": "INVALID_DATA",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "data": null}
{  "error": "INVALID_DATA",  "errorDescription": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "data": null}
"INVALID_DATA"
Empty