Etimad
Etimad Service – Government employee salary certificate & payslip inquiry APIs (NCGR)-plus bank contract details.
Description
Etimad Service – Government employee salary certificate & payslip inquiry APIs (NCGR)-plus bank contract details.
Endpoints
Endpoints are grouped as the provider publishes them, and are tied to a version and an environment. Changing either returns a different list.
Endpoints
3Retrieves the latest salary details for government employees
| Field | Location | Default Value | Description |
|---|---|---|---|
personalIdNumRequired | path | — | Employee National Number based on the Identification type |
birthDateRequired | query | — | Employee Birth Date - Input date in this format YYYY-MM-DD |
dateTypeRequired | query | — | Date Type (Hijri / Gregorian) |
idTypeRequired | query | — | Id Type These are the id types: 1 - Citizen 2 - Resident 3 - Other |
payMonthRequired | query | — | Pay Month of the salary certificate - Input date in this format YYYY-MM |
| Field | Type | Example |
|---|---|---|
data | array | […] |
data[].personalInfo | object | {…} |
data[].personalInfo.employeeNameAr | string | "علي خليل محمد المشلح" |
data[].employerInfo | object | {…} |
data[].employerInfo.agencyCode | string | "022001000000" |
data[].employerInfo.agencyName | string | "وزارة الصحة - الديوان العام" |
data[].bankInfo | object | {…} |
data[].bankInfo.accountNumber | string | "SA9080000621608010080389" |
data[].bankInfo.bankCode | string | "RJHI" |
data[].bankInfo.bankName | string | "مصرف الراجحي" |
data[].employmentInfo | object | {…} |
data[].employmentInfo.employeeJobNumber | string | "18991" |
data[].employmentInfo.employeeJobTitle | string | "مهندس مدني" |
data[].employmentInfo.agencyEmploymentDate | string | "2000-11-20" |
data[].payslipInfo | object | {…} |
data[].payslipInfo.payMonth | string | "2022-09" |
data[].payslipInfo.basicSalary | integer | 20000 |
data[].payslipInfo.totalAllowances | integer | 40 |
data[].payslipInfo.totalDeductions | integer | 1666 |
data[].payslipInfo.netSalary | integer | 18374 |
data[].allowances | array | […] |
data[].allowances[].allowanceCode | string | "1283" |
data[].allowances[].allowanceName | string | "بدل نقل أمتعة _ إنتداب" |
data[].allowances[].allowanceAmount | integer | 20 |
data[].deductions | array | […] |
data[].deductions[].deductionCode | string | "63215" |
data[].deductions[].deductionName | string | "حسم المؤسسة العامة للتقاعد" |
data[].deductions[].deductionAmount | integer | 1666 |
| Field | Type | Example |
|---|---|---|
errors | array | […] |
errors[].Code | string | "A001400" |
errors[].detail | string | "Some Required Fields are not fou…" |
errors[].type | string | "BusinessError" |
errors[].link | string | "" |
errors[].in | array | […] |
errors[].in[].name | string | "idType" |
errors[].in[].type | string | "query" |
Retrieves contract details for banks using the contract number.
| Field | Location | Default Value | Description |
|---|---|---|---|
contractNumberRequired | path | — | Contract number |
idTypeRequired | query | — | Vendor Identification Type |
idValueRequired | query | — | Value of CR or Id700 depend on idType |
Retrieves the latest salary certificate for government employees.
| Field | Location | Default Value | Description |
|---|---|---|---|
nationalNumberRequired | query | — | Employee National Number. |
birthDateRequired | query | — | Employee Birth Date - Input date in this format YYYY-MM-DD |
dateTypeRequired | query | — | Date Type (Hijri / Gregorian) |
| Field | Type | Example |
|---|---|---|
data | array | […] |
data[].personalInfo | object | {…} |
data[].personalInfo.employeeNameAr | string | "علي خليل محمد المشلح" |
data[].employerInfo | object | {…} |
data[].employerInfo.agencyCode | string | "022001000000" |
data[].employerInfo.agencyName | string | "وزارة الصحة - الديوان العام" |
data[].bankInfo | object | {…} |
data[].bankInfo.accountNumber | string | "SA9080000621608010080389" |
data[].bankInfo.bankCode | string | "RJHI" |
data[].bankInfo.bankName | string | "مصرف الراجحي" |
data[].employmentInfo | object | {…} |
data[].employmentInfo.employeeJobNumber | string | "18991" |
data[].employmentInfo.employeeJobTitle | string | "مهندس مدني" |
data[].employmentInfo.agencyEmploymentDate | string | "2000-11-20" |
data[].payslipInfo | object | {…} |
data[].payslipInfo.payMonth | string | "2022-09" |
data[].payslipInfo.basicSalary | integer | 20000 |
data[].payslipInfo.totalAllownces | integer | 40 |
data[].payslipInfo.totalDeductions | integer | 1666 |
data[].payslipInfo.netSalary | integer | 18374 |
| Field | Type | Example |
|---|---|---|
errors | array | […] |
errors[].Code | string | "A001400" |
errors[].detail | string | "Some Required Fields are not fou…" |
errors[].type | string | "BusinessError" |
errors[].link | string | "" |
errors[].in | array | […] |
errors[].in[].name | string | "X_MOF_RqUID" |
errors[].in[].type | string | "header" |
There is no plan currently.
Subscription Prerequisites
Prerequisite Documents
No prerequisite documents required
Select from Profile
No attachments found in your profile
Notice
Your request is under review. We'll let you know once the vendor responds.
KYC/KYB Required
You need to complete your KYC/KYB info first to subscribe
Review & Confirm
Check the package and its price. Nothing is created until you confirm.
- Package
- Package
- Number of requests
- —
VAT (15%) is added on the payment page, which shows the full total before you pay.
Provide Your Credentials
This API requires credentials provided by you. Enter the requested information below to continue your subscription.
Upgrade Required to Continue
This API supports Bring Your Own Key (BYOK), but your current subscription plan does not include BYOK access. Upgrade your plan to continue.
No Active Subscription Found
You do not have an active subscription plan. Please subscribe to a plan to continue.
Endpoints & Pricing
- 1View Pricing Details
- 2Configure & Subscribe
- 3Review & Confirm
Select the endpoints you need and enter the number of requests. Pricing is per request — volume discounts apply automatically.
| Endpoint | Method | Version | Base Price | Volume Tiers | Failed Call Price |
|---|
- Volume tiers: price per request drops as quantity increases. Tier applied automatically at checkout.
- Failed Call Price: deducted when the endpoint returns 4xx or 5xx. It is one fixed price per request and does not change with the volume tiers.
Select the endpoints you need and enter the number of requests. Pricing is per request — volume discounts apply automatically.
✦ Volume tiers: price per request drops as quantity increases. Tier applied automatically at checkout.
| Select Endpoints | Endpoint | Method | Version | Quantity (Requests) | Tier Applied | Price Per Request (success) | Subtotal | Failed Call Price |
|---|
✦ Failed Call Price: deducted when the endpoint returns 4xx or 5xx. It is one fixed price per request and does not change with the volume tiers.
Please select at least one endpoint and enter a quantity.
Notice
Your request is under review. We'll let you know once the vendor responds.
Consumer Warning Message
Important: The endpoints you are adding will be attached to your existing subscription and will follow the same expiry date and renewal cycle. The subscription period will not be extended for the newly added endpoints.
Endpoints Quota Detail
no data is available
Notice
Your request is under review. We'll let you know once the vendor responds.
Try the call
Copy the snippet in your preferred language, or open the console to run it in the browser.
Retrieves the latest salary details for government employees
Retrieves contract details for banks using the contract number.
Retrieves the latest salary certificate for government employees.