Emirates ID Get Name Async

introduction the emirates id get name api product provides a comprehensive solution for establishing that this emirates id belong to this person , offering several benefits and can be used for below purposes compliance business transactions identification and documentation risk management government oversight fraud prevention the emirates id get name api product facilitates seamless and reliable validation of the ownership of emirates id , enabling organizations to ensure compliance, enhance risk management practices, prevent fraud, and support secure and trustworthy interactions by leveraging this api, organizations can streamline their processes, improve data accuracy, and maintain the integrity of their operations in line with global standards what is an emirates id emirates id is an identity card issued by the federal authority for identity and citizenship ( https //www ica gov ae/ https //www ica gov ae/ ) it is a legal requirement for all uae citizens and residents to apply for one and carry it with them at all times the emirates id is used to get government services to vote in the elections of federal national council as a travel document for uae citizens to travel within the gcc as a document to pass immigration through the egates and smart gates at several airports in the uae structure of emirates id each emirates id card has a unique 15 digit number which is divided into 4 parts here is what they mean the 1st part is the same on all the cards and it represents uae international code, which is 784 the 2nd part matches your year of birth the 3rd part has 7 digits, which do not mean anything and are put together randomly by the system the 4th part is just a 1 digit and it stands for a verification number, which could be a digit from 0 to 9 the number of the id is designed for each person and stays with that person forever it cannot be changed or amended even if you stop being a uae resident and leave the country, in case you come back after a few years to get your residency again, the number assigned to your card will be the same again who can get an emirates id uae nationals gcc nationals residing in the uae expatriate residents note we strongly recommned using both emirates id verification prefill docid\ t4vbppixaxoaxgahvm5qh & emirates id get name async docid\ u l2qbwsl2bnrkvlilhx6 apis together emirates id verification api will establish that the inputs provided like emirates id number, nationality & dob are correct also, it will confirm the status & expiry date of emirates id emirates id get name api will confirm that this emirates id belongs to this person as we will fetch you the name of the emirates id card holder please note that this api doesn't establish that all emirates id number, nationality & dob are correct as per the physical issued emirates id and the id is active we use a govt source to fetch the name as per the 3 inputs and emirates id number has to be correct as a basic requirement coverage approximately 65% to 70% of emirates id data is available for coverage in this api rest of the data is not available from the source itself api applications b2b (business to business) applications background checks background screening companies can integrate these apis to verify the identity and background of individuals as part of pre employment screening or tenant verification services hr and payroll hr software providers can use these apis to validate employee identity and personal information for payroll processing and compliance with labor laws insurance insurance companies can use these apis for identity verification when underwriting policies, processing claims, and preventing insurance fraud legal services law firms may use these apis for client identity verification and conflict of interest checks education educational institutions can use these apis to verify student identities during the admission process and ensure accurate academic records travel and hospitality hotels and airlines can use these apis to verify passenger identities during bookings, enhancing security and streamlining check in processes government agencies different government departments can use these apis to share identity data securely for various purposes, such as immigration, law enforcement, or social services b2c (business to consumer) applications identity verification for online services online platforms and apps can use these apis to verify the identity of users during account registration users can submit their emirates id details, and the platform can use the apis to fetch and verify the user's information government services government agencies can offer online services that require identity verification citizens can use their emirates id to access services such as applying for licenses, permits, or accessing personal records e commerce e commerce platforms can use these apis to verify the identity of customers during the purchase process, enhancing security and preventing fraudulent transactions healthcare healthcare providers can use these apis to verify patient identities, ensuring that medical records are accurate and that the right treatment is provided to the right person banking and financial services banks can utilize these apis for customer identity verification during account opening, loan applications, and other financial transactions this helps in compliance with know your customer (kyc) regulations api endpoints the api consists of two main endpoints /api/v3/uae api/name emirates id async this endpoint is used to initiate a request for emirates id information using the provided data & callback url /api/v3/uae api/name emirates id get data this endpoint is used to fetch the requested information using the requestid received in the response of the initiate request emirates id initiate request async api the async api for fetching emirates id data is a powerful tool designed to provide asynchronous access to essential identity information related to individuals in the united arab emirates (uae) this api is particularly valuable for organizations and services that require accurate identity verification and data retrieval while ensuring a smooth and efficient user experience key features asynchronous processing the api operates asynchronously, allowing users to initiate data retrieval requests without the need for time consuming wait periods efficient data retrieval users can submit emirates id numbers, dates of birth, current nationalities, and callback urls to initiate data retrieval for individuals status tracking the api provides real time status updates, enabling users to monitor the progress of their data retrieval requests secure data handling emirates id data is handled with the utmost care and security to protect individuals' privacy and ensure compliance with data protection regulations api details you must first login before sending the request the authorization header in the request must include the access token obtained from the login api call initiating a request for an emiratesidnumber(async) need to pass the following information providing all input parameters is mandatory emiratesidnumber (required) dateofbirth (required) currentnationality (required) callbackurl (required) sample curl curl location 'https //api preproduction signzy app/api/v3/uae api/name emirates id async' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "emiratesidnumber" "784199453168392", "dateofbirth" "1994 09 11", "currentnationality" "palau", "callbackurl" "\<callbackurl>" }'curl location 'https //api signzy ae/api/v3/uae api/name emirates id async' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "emiratesidnumber" "\<emirates id number>", "dateofbirth" "\<yyyy mm dd>", "currentnationality" "\<country>", "callbackurl" "\<callback url>" }' request body parameters the api expects the following input in the request payload { "emiratesidnumber" "\<emirates id number>", "dateofbirth" "\<yyyy mm dd>", "currentnationality" "\<country>", "callbackurl" "\<callback url>" } parameter data type required description emiratesidnumber number yes required the emirates id which is to be verified emirates id should begin with ”784” next 4 parameters after 784 is year of birth that should match to the year of birth entered in date of birth dateofbirth string yes required date of birth of emirates id holder in yyyy mm dd format(mandatory) currentnationality string yes required current nationality of user(must be available in the list of supported countries please check emirates id verification prefill docid\ t4vbppixaxoaxgahvm5qh document for supported countries) callbackurl string yes required the url to which the api will send a response after processing the request(callbackurl should be correct and accessible in order to post the response) sample response request processing { "result" { "requestid" "\<request id>", "statuscode" 102, "status" "processing" } } request successful { "result" { "requestid" "\<request id>", "statuscode" 200, "status" "success" } } request failure { "result" { "requestid" "\<request id>", "statuscode" 409, "status" "failure" } } response body parameters parameter data type description requestid string requestid to track the request and use it in get data api statuscode string the status code of the request status string the message describing the current status of the api request sample error upstream error 409 { "error" { "name" "error", "message" "could not process the request try again later", "status" 409, "reason" "upstream error", "type" "conflict", "statuscode" 409 } } empty emiratesidnumber 400 { "error" { "name" "error", "message" "emiratesidnumber is not allowed to be empty", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } emiratesidnumber not passed 400 { "error" { "name" "error", "message" "\\"emiratesidnumber\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } malformatted emiratesidnumber 400 { "error" { "name" "error", "message" "bad request emiratesidnumber is invalid ", "reason" "validation error", "type" "bad request", "statuscode" "400" } } empty dateofbirth 400 { "error" { "name" "error", "message" "dateofbirth is not allowed to be empty", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } dateofbirth not passed 400 { "error" { "name" "error", "message" "\\"dateofbirth\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } malformatted dateofbirth 400 { "error" { "name" "error", "message" "bad request dateofbirth is invalid ", "reason" "validation error", "type" "bad request", "statuscode" "400" } } empty currentnationality 400 { "error" { "name" "error", "message" "currentnationality is not allowed to be empty", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } currentnationality not passed 400 { "error" { "name" "error", "message" "\\"currentnationality\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } malformatted currentnationality 400 { "error" { "name" "error", "message" "bad request currentnationality is invalid ", "reason" "validation error", "type" "bad request", "statuscode" "400" } } empty callbackurl 400 { "error" { "name" "error", "message" "callbackurl is not allowed to be empty", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } callbackurl not passed 400 { "error" { "name" "error", "message" "\\"callbackurl\\" is required", "status" 400, "reason" "validation error", "type" "bad request", "statuscode" "400" } } malformatted callbackurl 400 { "error" { "name" "error", "message" "bad request callbackurl is invalid ", "reason" "validation error", "type" "bad request", "statuscode" "400" } } internal server error 500 { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "conflict", "statuscode" 500 } } emirates id get data api the get data api is a robust solution that complements our async api for emirates id data retrieval it serves as the endpoint for efficiently retrieving emirates id data once it becomes available with this api, users can effortlessly access the requested identity information associated with a specific requestid, obtained from the async api's response key features data retrieval the getdata api facilitates the retrieval of emirates id data that was previously requested via the async api efficiency users can retrieve the data they need without the need to continuously poll for updates it ensures that users only receive the data when it is available data security emirates id data is handled with the utmost care and security, following stringent data protection protocols api details you must first login before sending the request the authorization header in the request must include the access token obtained from the login api call need to pass the following information providing requestid is mandatory requestid (required) sample curl curl location 'https //api preproduction signzy app/api/v3/uae api/name emirates id get data' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "requestid" "\<request id>" }'curl location 'https //api signzy ae/api/v3/uae api/name emirates id get data' \\ \ header 'content type application/json' \\ \ header 'authorization \<token>' \\ \ data '{ "requestid" "\<request id>" }' request body parameters the api expects the following input in the request payload { "requestid" "\<request id> (obtained from the first api)", } parameter data type required description requestid string yes required unique request id generated for the input provided in async api sample response success 200 { "result" { "requestid" "\<request id> (obtained from the first api)", "input" { "emiratesidnumber" "\<emirates id number>", "dateofbirth" "\<yyyy mm dd>", "currentnationality" "\<country>", "callbackurl" "\<callback url>" }, "statuscode" 200, "status" "success", "message" "emiratesid details found", "output" { "nameenglish" "\<name in english>", "namearabic" "\<name in arabic>", "maskedmobilenumber" "05 440" } } } response body parameters parameter data type description requestid string request id for which data is fetched input object the object containing input data for which output has been fetched statuscode number the status code of the request status string the message describing the current status of the api request message string the message describing the current status of the api request output object the object containing output response for given input data output parameters(response body) parameter data type description nameenglish string name of id card holder in english namearabic string name of id card holder in arabic maskedmobilenumber string masked mobile number of id card holder sample error malformatted requestid 400 { "error" { "name" "error", "message" "bad request requestid is invalid ", "reason" "validation error", "type" "bad request", "statuscode" "400" } } requestid not found 409 { "error" { "name" "error", "message" "requestid not found", "reason" "bad request", "type" "bad request", "statuscode" "40" } } error response parameters parameter description error this parameter contains the error error name the error name error message the error message error status s tatus of the api error reason reason for error error type type of the error error statuscode request status code from signzy 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 help\@signzy com 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!