This guide is designed to help you understand WATHQ APIs. Here, you will find everything you need start using services. Starting from Sign In. Going through each product documentation. Until you send your first request.
Create your own developer account by filling out the Sign Up page. Once you've verified your email address, you'll be able to create your first application.
Log in and we will guide you to create your first application. You will be able to create only one application for the free package.
Your applications can now be accessed in My Apps.
Soon as you create your first application. You will be able to view the application details by clicking on Review button on your application. Then, you will be able to obtain your App Key for this application.
You are now ready to send your first request.
We strongly advise you to go through each product documentation before sending any request. You will be allowed to use only authorized services based on your subscribed package. Below is a sample for how to call service
curl -X GET "https://api.wathq.sa/v4/commercialregistration/info/1010XXXXXX" \
-H "accept: application/json" \
-H "apiKey: YOURAPIKEY
1010XXXXXX - is a commercial record number or an entity number which start with 7.
YOURAPIKEY - is your registered application Consumer Key
Below is a response sample of one success request (http status = 200)
{
"cr_info": {
"cr_name": "اسم السجل التجاري",
"cr_number": 1010XXXXXX,
"cr_entity_no": 7015XXXXXX,
"cr_issue_date": "1440/10/29",
"cr_expiry_date": "1441/10/29",
"cr_main_number": null,
"cr_bus_type": {
"id": "101",
"name": "مؤســـسة فـــردية"
},
"cr_fiscal": {
"month": 10,
"day": 28,
"calendar_type": {
"id": 1,
"calendar_type": "هجري"
}
},
"cr_status": {
"id": "active",
"name": "السجل التجاري قائم",
"name_en": "السجل التجاري قائم"
},
"cr_cancellation": null,
"cr_location": {
"id": "1010",
"name": " الرياض"
},
"cr_company": null,
"cr_activities": {
"description": "أعمال ورش النجارة بشكل عام،صناعة المباني الخشبية سابقة التجهيز،أنشطة أخرى خاصة بانتاج وصناعة منتجات النجارة المستخدمة في البناء والتشييد",
"isic": [
{
"id": "162250",
"name": "أعمال ورش النجارة بشكل عام",
"name_en": "Carpentry works"
},
{
"id": "162270",
"name": "صناعة المباني الخشبية سابقة التجهيز",
"name_en": "Manufacture of prefabricated wooden buildings"
},
{
"id": "162290",
"name": "أنشطة أخرى خاصة بانتاج وصناعة منتجات النجارة المستخدمة في البناء والتشييد",
"name_en": "Other activities of production and manufacture of carpentry products used in construction"
}
]
}
}
}
All api responses whether failed or success will be returned with a unique reference number. Reference number will be found on the response header by name THIQAH-API-ApiMsgRef. Please use this reference number to identify any issue when reaching WATHQ support and for any future inquires on each request.
THIQAH-API-ApiMsgRef →6c7d7d44-b1f8-4b1a-8db1-4dbca3370f57