> For the complete documentation index, see [llms.txt](https://lumin-soft.gitbook.io/ekyc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lumin-soft.gitbook.io/ekyc/integration-throw-api/update-api/update-national-id.md). # Update National Id 1. ### Verify Password ## POST /Onboarding/api/v1/update/PasswordUpdateAuthentication/VerifyPassword > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"VerifyPasswordForStepDto":{"type":"object","properties":{"password":{"type":"string","nullable":true},"updateStepId":{"$ref":"#/components/schemas/UpdateStepEnum"}},"additionalProperties":false},"UpdateStepEnum":{"enum":[1,2,3,4,5,6,7,8,9,10],"type":"integer","format":"int32"},"SuccessStatusStatusResultDto":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/SuccessStatus"}},"additionalProperties":false},"SuccessStatus":{"type":"integer","format":"int32","description":"Indicates the result of the operation. 0 = Success, 1 = Failed.","enum":[0,1]}}},"paths":{"/Onboarding/api/v1/update/PasswordUpdateAuthentication/VerifyPassword":{"post":{"tags":["PasswordUpdateAuthentication"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyPasswordForStepDto"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessStatusStatusResultDto"}}}}}}}}} ``` ### Upload National Id Front Image : ## POST /Onboarding/api/v1/update/UpdateNationalId/UploadFrontImage > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"UploadUpdateDocumentDto":{"type":"object","properties":{"customerId":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}},"additionalProperties":false},"DocumentScanResultDto":{"type":"object","properties":{"isSuccess":{"type":"boolean"},"message":{"type":"string","nullable":true},"errorCode":{"type":"string","nullable":true},"customerData":{"$ref":"#/components/schemas/GetCustomerDataDto"}},"additionalProperties":false},"GetCustomerDataDto":{"type":"object","properties":{"customerId":{"type":"string","nullable":true,"description":"Client unique identifier."},"idFrontScan":{"type":"string","nullable":true,"description":"National Id detected at front-side image."},"idBackScan":{"type":"string","nullable":true,"description":"National Id detected at back-side image."},"photo":{"type":"string","nullable":false,"description":"Path of detected client image at national Id front-side."},"fullName":{"type":"string","nullable":false,"description":"Arabic full name of client."},"fullNameEn":{"type":"string","nullable":true,"description":"English full name of client."},"firstName":{"type":"string","nullable":false,"description":"Arabic first name of client."},"firstNameEn":{"type":"string","nullable":true,"description":"English first name of client."},"familyName":{"type":"string","nullable":false,"description":"Arabic family name of client."},"familyNameEn":{"type":"string","nullable":true,"description":"English family name of client."},"address":{"type":"string","nullable":false,"description":"Address of client."},"state":{"type":"string","nullable":false,"description":"Address state of client."},"birthdate":{"type":"string","format":"date-time","nullable":false,"description":"Birthdate of client."},"idNumber":{"type":"string","nullable":false,"description":"National ID number of client."},"idNumberBack":{"type":"string","nullable":true,"description":"National Id number detected at back-side of national Id."},"documentNumber":{"type":"string","nullable":true,"description":"Factory number detected at front-side of national Id."},"documentTypeId":{"type":"string","nullable":true,"description":"Documet type detected at while scanning. Can be Identity-type or passport"},"documentTypeCode":{"type":"string","nullable":true,"description":"Documet type code detected at while scanning. Can be Identity-type or passport (EGY)"},"issueDate":{"type":"string","format":"date-time","nullable":true,"description":"Issue date of national Id card."},"profession":{"type":"string","nullable":true,"description":"Job detected at national Id card."},"maritalStatus":{"type":"string","nullable":true,"description":"Marital status detected at national Id card."},"religion":{"type":"string","nullable":true,"description":"Relegious detected at national Id card."},"gender":{"type":"string","nullable":true,"description":"Gender detected at national Id card."},"nationality":{"type":"string","nullable":true,"description":"Nationality code of client (egy)."},"detectedAge":{"type":"integer","format":"int32","description":"Detected age from client photo."},"detectedGender":{"type":"string","nullable":true,"description":"Detected gender from client photo."},"expirationDate":{"type":"string","format":"date-time","nullable":true,"description":"National id card expiration date."}},"additionalProperties":false}}},"paths":{"/Onboarding/api/v1/update/UpdateNationalId/UploadFrontImage":{"post":{"tags":["UpdateNationalId"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadUpdateDocumentDto"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentScanResultDto"}}}}}}}}} ``` ### Upload National Id Back Image : ## POST /Onboarding/api/v1/update/UpdateNationalId/UploadBackImage > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"UploadUpdateDocumentDto":{"type":"object","properties":{"customerId":{"type":"string","nullable":true},"image":{"type":"string","nullable":true}},"additionalProperties":false},"DocumentScanResultDto":{"type":"object","properties":{"isSuccess":{"type":"boolean"},"message":{"type":"string","nullable":true},"errorCode":{"type":"string","nullable":true},"customerData":{"$ref":"#/components/schemas/GetCustomerDataDto"}},"additionalProperties":false},"GetCustomerDataDto":{"type":"object","properties":{"customerId":{"type":"string","nullable":true,"description":"Client unique identifier."},"idFrontScan":{"type":"string","nullable":true,"description":"National Id detected at front-side image."},"idBackScan":{"type":"string","nullable":true,"description":"National Id detected at back-side image."},"photo":{"type":"string","nullable":false,"description":"Path of detected client image at national Id front-side."},"fullName":{"type":"string","nullable":false,"description":"Arabic full name of client."},"fullNameEn":{"type":"string","nullable":true,"description":"English full name of client."},"firstName":{"type":"string","nullable":false,"description":"Arabic first name of client."},"firstNameEn":{"type":"string","nullable":true,"description":"English first name of client."},"familyName":{"type":"string","nullable":false,"description":"Arabic family name of client."},"familyNameEn":{"type":"string","nullable":true,"description":"English family name of client."},"address":{"type":"string","nullable":false,"description":"Address of client."},"state":{"type":"string","nullable":false,"description":"Address state of client."},"birthdate":{"type":"string","format":"date-time","nullable":false,"description":"Birthdate of client."},"idNumber":{"type":"string","nullable":false,"description":"National ID number of client."},"idNumberBack":{"type":"string","nullable":true,"description":"National Id number detected at back-side of national Id."},"documentNumber":{"type":"string","nullable":true,"description":"Factory number detected at front-side of national Id."},"documentTypeId":{"type":"string","nullable":true,"description":"Documet type detected at while scanning. Can be Identity-type or passport"},"documentTypeCode":{"type":"string","nullable":true,"description":"Documet type code detected at while scanning. Can be Identity-type or passport (EGY)"},"issueDate":{"type":"string","format":"date-time","nullable":true,"description":"Issue date of national Id card."},"profession":{"type":"string","nullable":true,"description":"Job detected at national Id card."},"maritalStatus":{"type":"string","nullable":true,"description":"Marital status detected at national Id card."},"religion":{"type":"string","nullable":true,"description":"Relegious detected at national Id card."},"gender":{"type":"string","nullable":true,"description":"Gender detected at national Id card."},"nationality":{"type":"string","nullable":true,"description":"Nationality code of client (egy)."},"detectedAge":{"type":"integer","format":"int32","description":"Detected age from client photo."},"detectedGender":{"type":"string","nullable":true,"description":"Detected gender from client photo."},"expirationDate":{"type":"string","format":"date-time","nullable":true,"description":"National id card expiration date."}},"additionalProperties":false}}},"paths":{"/Onboarding/api/v1/update/UpdateNationalId/UploadBackImage":{"post":{"tags":["UpdateNationalId"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadUpdateDocumentDto"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentScanResultDto"}}}}}}}}} ``` ### Approve National Id Front Image : ## POST /Onboarding/api/v1/update/UpdateNationalId/ApproveFrontImage > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"ApproveNationalIdFrontDto":{"type":"object","properties":{"fullNameEn":{"type":"string","nullable":true,"description":"Client english full name.\n Attribute is used when translation feature was enabled from admin panel configuration.\n If the english full name has no changes you can pass the same value of OCR translated result.\n It is mandatory if trasnslate feature was enabled."},"firstNameEn":{"type":"string","nullable":true,"description":"Client english first name.\n Attribute is used when translation feature was enabled from admin panel configuration.\n If the english first name has no changes you can pass the same value of OCR translated result.\n It is mandatory if trasnslate feature was enabled."},"familyNameEn":{"type":"string","nullable":true,"description":"Client english family name.\n Attribute is used when translation feature was enabled from admin panel configuration.\n If the english family name has no changes you can pass the same value of OCR translated result.\n It is mandatory if trasnslate feature was enabled."}},"additionalProperties":false},"SuccessStatusStatusResultDto":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/SuccessStatus"}},"additionalProperties":false},"SuccessStatus":{"type":"integer","format":"int32","description":"Indicates the result of the operation. 0 = Success, 1 = Failed.","enum":[0,1]}}},"paths":{"/Onboarding/api/v1/update/UpdateNationalId/ApproveFrontImage":{"post":{"tags":["UpdateNationalId"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApproveNationalIdFrontDto"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessStatusStatusResultDto"}}}}}}}}} ``` ### Approve National Id Back Image : ## POST /Onboarding/api/v1/update/UpdateNationalId/ApproveBackImage > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"SuccessStatusStatusResultDto":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/SuccessStatus"}},"additionalProperties":false},"SuccessStatus":{"type":"integer","format":"int32","description":"Indicates the result of the operation. 0 = Success, 1 = Failed.","enum":[0,1]}}},"paths":{"/Onboarding/api/v1/update/UpdateNationalId/ApproveBackImage":{"post":{"tags":["UpdateNationalId"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessStatusStatusResultDto"}}}}}}}}} ``` ### Check If Translation Is Enabled ## GET /Onboarding/api/v1/update/UpdateNationalId/IsTranaslationStepEnabled > ```json {"openapi":"3.0.1","info":{"title":"eKYC Onboarding APIs (Local Env.)","version":"1.0"},"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Please insert JWT with Bearer into field","name":"Authorization","in":"header"}},"schemas":{"BooleanSingleResultDto":{"type":"object","properties":{"value":{"type":"boolean"}},"additionalProperties":false}}},"paths":{"/Onboarding/api/v1/update/UpdateNationalId/IsTranaslationStepEnabled":{"get":{"tags":["UpdateNationalId"],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BooleanSingleResultDto"}}}}}}}}} ```