Corporate
Mohre Services
MOHRE Services

Description

MOHRE (Ministry of Human Resources and Emiratization) APIs enable corporate customers to access real-time employee and employer WPS information, supporting wage verification, payroll file preparation, and WPS status checks to streamline salary processing and compliance.

In order to subscribe, Please

  • Overview
  • APIs Offered
    Employee Wage Verification

    The API validates key information such as labour card details, employment contract information, and the employee’s registered salary to support accurate WPS salary processing.

    Employee Wage Verification
    View API Specifications

    The API validates key information such as labour card details, employment contract information, and the employee’s registered salary to support accurate WPS salary processing.

    NOTE:

    • Applications must obtain an access token through the Get Token API before invoking any MOHRE REST APIs. The generated token must be included in subsequent API requests and remains valid for 180 seconds.

    Flow Chart

    Image
    Flow Chart Employee Wage Verification

    What operations can be performed?

    1. getEmployees: This GET method is used to retrieve and verify the employee details before preparing the Payroll file.

    Request Headers:

    Fields
    Description
    Mandatory/Optional
    Data Type
    Length
    Sample Value
    CIF
    Customer CIF
    Mandatory
    NUMERIC
    9
    "10150935"
    emiratesID
    Company Owner Emirates ID
    Mandatory
    STRING
    15
    "784199342195100"
    registrationNumber
    Registration number issued to the specific company employer or domestic sponsor registered with MOHRE WPS
    Mandatory
    STRING
    20
    C001092724092399292/ D008121825141449807505

    Request Parameters:

    Fields
    Description
    Mandatory/Optional
    Data Type
    Length
    Sample Value
    CIF
    Customer CIF
    Mandatory
    NUMERIC
    9
    "10150935"
    emiratesID
    Company Owner Emirates ID
    Mandatory
    STRING
    15
    "784199342195100"
    registrationNumber
    Registration number issued to the specific company employer or domestic sponsor registered with MOHRE WPS
    Mandatory
    STRING
    20
    C0010927240923992922/
    D0081218251449807505
    pageIndex
    Page number for paginated results (starting from 0 or 1 based on API design)
    Optional
    NUMERIC
    5
    1
    pageSize
    Number of records per page
    Optional
    NUMERIC
    5
    10

    Response Parameters:

    Response Name
    Description
    Field Type
    Length
    Sample value
    cif
    Customer CIF
    test
    9
    "10150935"
    response.respData
    Response Data Object
    Object
    -
    -
    response.respData.metadata.totalPages
    Total Pages as per page size and page index
    String
    3
    "10"
    response.respData.metadata.totalItems
    Total Items as per page size and page index
    String
    3
    "20"
    response.respData.employeeList
    Employee List
    List
    -
    -
    employeeList.cardNumber
    Employee Work Permit card number
    Integer
    15
    30781102
    employeeList.unifiedNumber
    Employee unified number
    String
    15
    "54650865"
    employeeList.employeeEmiratesID
    Employee Emirates ID
    String
    15
    "784198491593285"
    employeeList.employeeList.statusDated
    Status Date
    String
    200
    "2024-09-06"
    employeeList.isActive
    Employee Active status
    Boolean
    4
    TRUE
    employeeList.passportNumber
    Employee passport number
    String
    15
    "A26449872"
    employeeList.totalSalary
    Employee total salary
    Decimal
    20
    2000
    employeeList.employeeName
    Employee Name
    String
    200
    "JOHN ASAAD LEWIS MIKHAEL"
    employeeList.employeeNameAr
    Employee Name Arabic
    String
    200
    "جوان اسعد لويس ميخائيل"
    employeeList.personCode
    Employee Person Code
    String
    15
    "00101018422398"

    Status Code Information:

    Status code
    Status
    Description
    200
    SUCCESS
    Request processed successfully
    400
    FAILED
    Mandatory field is missing in the request
    400
    FAILED
    Mandatory field value is null
    401
    REJECTED
    Field value does not match allowed enumeration
    400
    REJECTED
    Field value length is less than minimum allowed
    400
    REJECTED
    Field value length is greater than maximum allowed
    500
    REJECTED
    Hash value does not match the request body
    500
    REJECTED
    Hash value is missing or invalid
    IMPORTANTS NOTES:
    • The employer must be registered with MOHRE and have a valid MOHRE Registration Number.
    • The API retrieves employee salary information based on the employer and employee details maintained in MOHRE records.
    • Employee information returned by the API is subject to the latest data available in MOHRE systems.
    • The API should be used to validate employee salary details before preparing and submitting WPS salary files.
    • Access to employee information is restricted to authorized employers and approved corporate customers in accordance with MOHRE policies.
    Employer WPS Status

    Enables corporate customers to retrieve the employer’s latest WPS status from MOHRE in real time for the past 24 months

    Employer WPS Status
    View API Specifications

    Enables corporate customers to retrieve the employer’s latest WPS status from MOHRE in real time for the past 24 months

    NOTE:

    • Applications must obtain an access token through the Get Token API before invoking any MOHRE REST APIs. The generated token must be included in subsequent API requests and remains valid for 180 seconds.

    Flow Chart

    Image
    Flow Chart Employer WPS Status

    What operations can be performed?

    1. getEmployees: This GET method is used to retrieve the employer WPS status.

    Request Headers:

    Fields
    Description
    Mandatory/Optional
    Data Type
    Length
    Sample Value
    X-entity
    Entity
    Mandatory
    NUMERIC
    9
    AE
    clientId
    Client provided to customer
    Mandatory
    STRING
    15
    -

    Request Parameters:

    Fields
    Description
    Mandatory/Optional
    Data Type
    Length
    Sample Value
    CIF
    Customer CIF
    Mandatory
    NUMERIC
    9
    "10150935"
    emiratesID
    Company Owner Emirates ID
    Mandatory
    STRING
    15
    "784199342195100"
    registrationNumber
    MOHRE Registration Number
    Mandatory
    STRING
    20
    C0010927240923992922

    Response Parameters:

    Response Name
    Description
    Field Type
    Length
    Sample value
    cif
    Customer CIF
    test
    9
    "10150935"
    response.respData
    Response Data Object
    Object
    -
    -
    response.respData.WPSStatus
    WPS Status list
    List
    -
    -
    WPSStatus.status
    WPS Payment Status
    String
    20
    "WPS Paid for Month : 202408"
    WPSStatus.month
    Payroll Month
    String
    6–20
    "202408"
    WPSStatus.statusDate
    Status Date (if available)
    String
    200
    "2022-07-20"

    Status Code Information:

    Status code
    Status
    Description
    200
    SUCCESS
    Request processed successfully
    400
    FAILED
    Mandatory field is missing in the request
    400
    FAILED
    Mandatory field value is null
    401
    REJECTED
    Field value does not match allowed enumeration
    400
    REJECTED
    Field value length is less than minimum allowed
    400
    REJECTED
    Field value length is greater than maximum allowed
    500
    REJECTED
    Hash value does not match the request body
    500
    REJECTED
    Hash value is missing or invalid
    IMPORTANTS NOTES:
    • The employer must be registered with MOHRE and possess a valid MOHRE Registration Number.
    • The API retrieves the employer's current WPS status based on the latest information available in MOHRE systems.
    • The employer identifier provided in the request must match the records maintained by MOHRE.
    • Access to employer WPS status information is restricted to authorized corporate customers in accordance with MOHRE policies.
    • The API response reflects the status available at the time of inquiry and may change based on updates in MOHRE records.
Number of API/s
2
Number of APIs
APIC Calls
160
K
Calls per month
Active users
250
Active users
Regions
Overview
Overview

MOHRE WPS APIs enable corporate customers to access employee and employer WPS information directly from MOHRE. These APIs support wage verification and WPS status checks, helping customers prepare and process salary files efficiently and accurately.

What are the benefits?
  • Improved compliance and regulatory alignment

    MOHRE integration supports timely validation of employment, work permit, and contract-related information, helping organizations align their processes with UAE labour requirements and reduce the risk of incomplete or outdated records.

  • Faster onboarding and service fulfilment

    API-based access can streamline employment verification and related checks, reducing dependency on manual document collection and follow-up with customers or employers.

  • Reduced operational effort

    Automated data exchange minimizes repetitive manual entry, document review, and exception handling, enabling operations teams to focus on higher-value activities.

  • Improved data accuracy and consistency

    Direct integration with an authoritative government source helps reduce errors caused by manual transcription, inconsistent customer submissions, or outdated supporting documents.

  • Enhanced customer and employer experience

    Faster validation and fewer document requests can simplify journeys for corporate clients, employees, and internal users, creating a more seamless digital experience.

  • Better risk management

    Verified employment and labour-related data can strengthen due diligence, eligibility checks, wage-related validations, and exception monitoring across banking and payroll use cases.

  • Scalable digital processing

    MOHRE APIs enable organizations to handle higher transaction volumes without proportionate increases in manual capacity, making the operating model more scalable and resilient.

 
Which APIs are offered?
  • getEmployees API (WPS0006): Enables corporate customers to retrieve real-time employee wage and employment details from MOHRE. The API validates key information such as labour card details, employment contract information, and the employee’s registered salary to support accurate WPS salary processing.
  • getemployerWpsStatus API (WPS0008): Enables corporate customers to retrieve the employer’s latest WPS status from MOHRE in real time for the past 24 months

 

By leveraging MOHRE APIs, corporate customers can streamline payroll file preparation, validate wage information, and obtain real-time WPS status updates for improved efficiency and compliance.

What can I do with this API ?
icon
icon
icon
Product benefits
Verify employer information confirm whether a company/employer record is valid and aligned with MOHRE records.
Employee Wage Verification Verify employee wage and salary information before payroll submission.
Employee Status Retrieval Retrieve employee status and employment details directly from MOHRE in real time.
Employer WPS Verification Check Employer's WPS status and payment processing outcomes.
MOHRE Services
Engage with us
Get started today or reach out to learn more.
 
Register today to access and get started with our tools and API documentation.
 
Schedule a call with our team to understand how our offering can support you and your customers.