Mofeed Employment Services

Description

Mofeed – GOSI Masdr Employment Services provide APIs for retrieving individuals' employment status using National ID or Iqama numbers through different service packages, as well as establishment and employee statistics to support employment verification and system integration.

Documentation

توفر خدمات مصدر مفيد واجهات برمجية تتيح للأنظمة والمنصات الرقمية الاستعلام عن بيانات الحالة الوظيفية للأفراد وإحصائيات المنشآت والموظفين في المملكة العربية السعودية، من خلال التكامل مع خدمات مصدر المرتبطة ببيانات التأمينات الاجتماعية.

تشمل الخدمات المتاحة:

الاستعلام عن الحالة الوظيفية – الباقة الفضية: استرجاع بيانات الحالة الوظيفية للأفراد باستخدام رقم الهوية الوطنية أو الإقامة، وفق نطاق المعلومات المتاحة ضمن الباقة الفضية.
الاستعلام عن الحالة الوظيفية – الباقة الذهبية: الحصول على بيانات الحالة الوظيفية للأفراد باستخدام رقم الهوية الوطنية أو الإقامة، وفق نطاق المعلومات المتاحة ضمن الباقة الذهبية.
الاستعلام عن الحالة الوظيفية – الباقة البلاتينية: استرجاع بيانات الحالة الوظيفية للأفراد باستخدام رقم الهوية الوطنية أو الإقامة، وفق نطاق المعلومات المتاحة ضمن الباقة البلاتينية.
الاستعلام عن إحصائيات المنشآت: استرجاع البيانات الإحصائية المتعلقة بالمنشآت باستخدام رقم التسجيل أو الرقم الموحد للمنشأة.
الاستعلام عن إحصائيات موظفي المنشأة: الحصول على الإحصائيات المتعلقة بموظفي المنشأة باستخدام معرف المنشأة ومعرف مكتب العمل.

تشمل البيانات المسترجعة معلومات الحالة الوظيفية والارتباطات الوظيفية والأجور والبدلات وبيانات جهات العمل، بالإضافة إلى الإحصائيات المتعلقة بالمنشآت والموظفين، بحسب الخدمة المستخدمة والباقة المحددة والبيانات المتاحة.

تساهم هذه الخدمات في تسهيل التكامل بين الأنظمة، وأتمتة عمليات الاستعلام والتحقق من بيانات التوظيف، وتعزيز دقة وموثوقية المعلومات المستخدمة في الإجراءات التشغيلية والخدمات الرقمية، مع مراعاة متطلبات حماية البيانات وسرية المعلومات.

Endpoints

Endpoints are grouped as the provider publishes them, and are tied to a version and an environment. Changing either returns a different list.

EnvironmentFilter bySearch with the Endpoints

Endpoints

5

Retrieves employment status information using the Gold package by NIN or Iqama.

Field	Location	Default Value	Description
`ninOrIqama`Required	path	—	Legal identification number of the employee; 10 characters, e.g 1234567890

Retrieves employment status information using the Silver package by NIN or Iqama.

Field	Location	Default Value	Description
`ninOrIqama`Required	path	—	Legal identification number of the employee; 10 characters, e.g 1234567890

Retrieves employee statistics details by establishment ID and office ID.

Field	Location	Default Value	Description
`molEstID`Required	path	—	MOL Establishment ID, e.g 31111
`molEstOfficeID`Required	path	—	MOL Establishment Office ID, e.g 1

Example Responses

Field	Type	Example
`nationality`	string	"Saudi Arabia"
`gender`	string	"Male"
`numberOfSaudiMale`	integer	3131111
`numberOfSaudiFemale`	integer	131111
`numberOfNonSaudiMale`	integer	231111
`numberOfNonSaudiFemale`	integer	131111
`wageOfSaudiMale`	integer	1217
`wageOfSaudiFemale`	integer	116
`wageOfNonSaudiMale`	integer	11
`wageOfNonSaudiFemale`	integer	12

Field	Type	Example
`severity`	string	"1"
`errorCode`	string	"SOI_ERR_3331"
`errorText`	string	"م يتم ارسال احد المعايير بشكل صح…"
`errorTitle`	string	"تنبيه"

Retrieves employment status information using the Platinum+ package by NIN or Iqama.

Field	Location	Default Value	Description
`ninOrIqama`Required	path	—	Legal identification number of the employee; 10 characters, e.g 1234567890

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.

Try the call

Copy the snippet in your preferred language, or open the console to run it in the browser.

Retrieves employment status information using the Gold package by NIN or Iqama.

Terms of Use

For testing purposes, please use the following sample data when validating the integration and related business flows: NIN/Iqama Number: 1010101000 MOL Establishment ID: 31111 MOL Establishment Office ID: 1 Registration Number / Unified ID: 7000000000

API Marketplace

Developers

Products

Solutions

Company

Mofeed Employment Services

Description

Documentation

Endpoints

Endpoints

Notice

Consumer Warning Message

Endpoints Quota Detail

Notice

Try the call

Terms of Use