UAE Company Visa Quota Permit

Overview

This API serves as a tool for obtaining detailed information on company profiles and their corresponding labor quota details within a specific region. Upon receiving a request with a company's license number and an option to include quota details, the API responds with an extensive profile of the company. This profile includes basic company information such as name, labor office association, and category. Additionally, if requested, the API provides a comprehensive breakdown of quota details for various job positions within the company, detailing transaction numbers, job codes, descriptions, gender specifications, and the status of requests, approvals, and usage.

This API is particularly useful for businesses and regulatory agencies to manage and monitor labor allocations and ensure compliance with local employment regulations. It offers a straightforward interface for retrieving up-to-date data on company operations and workforce management, making it an essential tool for workforce planning and regulatory oversight.

Usecases:

Regulatory Compliance Monitoring: Government bodies and regulatory agencies can use the API to monitor companies for compliance with employment laws and regulations. They can verify that companies are adhering to approved quotas for various job positions, and ensure that all staffing activities are within legal limits.
Audit and Reporting: Companies can use this API to generate reports on their current workforce status and quota usage. This is particularly useful for internal audits, compliance checks, and preparing documentation for regulatory submissions or investor presentations.
Business Analysis and Strategy: Analysts can use the API to gather data on labor trends within specific sectors or regions. This information can be used for market analysis, strategic decision-making, and competitive analysis.

API Details

Sample cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/uae-api/company-visa-quota-info' \
--header 'Content-Type: application/json' \
--header 'Authorization: <-----AuthToken----->' \
--data '{
    "licenseNumber":"1012916",
    "quotaDetails": true
}'

Request Body Parameters:

Input	Datatype	Mandatory/Optional	Description
licenseNumber	String	Mandatory	The unique identifier for the company's license. (Obtainted from the Company Info License number API output)
quotaDetails	Boolean	Mandatory	Specifies whether to include detailed quota information in the response.

Sample API Response

{
    "result": {
        "companyInfo": {
            "companyName": "BABU DOON TECHNICAL SERVICES L.L.C",
            "labourOffice": "Dubai",
            "companyCode": "1012916",
            "category": "3"
        },
        "quotaDetails": [
            {
                "transactionNumber": "MB193415889AE",
                "jobCode": "5132135",
                "description": "CLEANING WORKER",
                "gender": "Male",
                "requested": "1",
                "approved": "1",
                "used": "1",
                "cancelled": "0"
            },
            .
            .
            .
            .
            .
            {
                "transactionNumber": "MB993966494AE",
                "jobCode": "931307015",
                "description": "Tile Layer Assistant",
                "gender": "Male",
                "requested": "1",
                "approved": "0",
                "used": "0",
                "cancelled": "0"
            }
        ],
        "newActivityQuota": [
            {
                "transactionNumber": "MB993966494AE",
                "jobCode": "332201013",
                "description": "Commercial Sales Representative",
                "gender": "Male",
                "requested": "4",
                "approved": "4",
                "used": "4",
                "cancelled": "0"
            }
        ],
        "total": {
            "requested": "26",
            "approved": "24",
            "used": "21",
            "cancelled": "0"
        }
    }
}

Response Body Parameters

API Output Structure

Object	Attribute	Datatype	Description
companyInfo		object	Contains information about the company.
	companyName	String	The registered name of the company.
	labourOffice	String	The labor office with jurisdiction over the company.
	companyCode	String	The unique code identifying the company.
	category	String	The category classification of the company.
quotaDetails		object	Details of quotas for specific job roles within the company.
	transactionNumber	String	Unique identifier for the transaction.
	jobCode	String	Code that identifies the specific job role.
	description	String	Description of the job role.
	gender	String	The gender for which the job role is designated.
	requested	String	The number of job positions requested.
	approved	String	The number of job positions approved by the authorities.
	used	String	The number of approved positions that have been filled.
	cancelled	String	The number of job positions cancelled.
newActivityQuota		object	Quotas for newly added job roles.
	transactionNumber	String	Unique identifier for the new activity transaction.
	jobCode	String	Code that identifies the new job role.
	description	String	Description of the new job role.
	gender	String	The gender for which the new job role is designated.
	requested	String	The number of new job positions requested.
	approved	String	The number of new job positions approved by the authorities.
	used	String	The number of approved new positions that have been filled.
	cancelled	String	The number of new job positions cancelled.
total		object	Aggregated totals of all quota transactions.
	requested	String	Total number of positions requested across all roles.
	approved	String	Total number of positions approved across all roles.
	used	String	Total number of positions filled across all roles.
	cancelled	String	Total number of positions cancelled across all roles.

Error Code Responses

{
    "error": {
        "name": "error",
        "message": "Data not found",
        "status": "404",
        "reason": "NOT_FOUND",
        "type": "Not Found",
        "statusCode": 200
    }
}

Error Response Parameters

Parameter	Description
error	This parameter contains the error
error.name	The name of the error
error.message	The error message
error.statusCode	Request Status code from Signzy
error.reason	Reason for error
error.type	Type of the error

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!