Mexico CURP Fetch

overview the global kyc curp fetch api allows users to retrieve comprehensive personal and documentation details associated with a given curp (clave única de registro de población) code this api is specifically tailored for entities requiring identity verification and authentication within mexico use case this api is utilized by financial institutions, insurance companies, and any organization involved in kyc (know your customer) compliance to verify the identity of mexican citizens through their curp codes it ensures that the personal details are accurate and up to date, facilitating user onboarding, risk assessment, and regulatory compliance api details request body preproduction curl location 'https //api preproduction signzy app/api/v3/global kyc/mx/curp fetch' \\ \ header 'content type application/json' \\ \ header 'authorization s9sgyhjbgh0ovujlgtokxb1j5nlndlsj' \\ \ data '{ "curp" "gafa630717hdfrnl07" }' production curl location 'https //api signzy app/api/v3/global kyc/mx/curp fetch' \\ \ header 'content type application/json' \\ \ header 'authorization s9sgyhjbgh0ovujlgtokxb1j5nlndlsj' \\ \ data '{ "curp" "gafa630717hdfrnl07" }' request body parameters parameter type description required curp string the curp code to fetch details for must be 18 characters long yes response body successful response { "result" { "personalinformation" { "firstname" "jose alejandro", "fatherlastname" "garibay", "motherlastname" "fuentes", "curp" "gafa630717hdfrnl07", "gender" "male", "dateofbirth" "1963 07 17", "countryofbirth" "mexico", "stateofbirth" "distrito federal", "curpstatus" "an" }, "documentationdetails" { "registrationyear" "1963", "registrationstate" "distrito federal", "actnumber" "00016" } } } response body parameters parameter type description firstname string first name of the individual fatherlastname string father's last name motherlastname string mother's last name curp string curp code gender string gender of the individual dateofbirth date date of birth (format yyyy mm dd) countryofbirth string country of birth stateofbirth string state of birth within mexico curpstatus string status of the curp code registrationyear string year of registration registrationstate string state of registration actnumber string act number associated with the curp registration error code and response mapping 400 (bad request) { "error" { "name" "error", "message" "invalid input for curp", "status" 400, "reason" "validation request", "type" "bad request", "statuscode" 400 } } 401(unauthorized) { "error" { "name" "error", "message" "invalid authentication credentials", "status" 401, "reason" "authentication error", "type" "bad request", "statuscode" 401 } } 404(data not found) { "error" { "name" "error", "message" "data not found in source", "status" 404, "reason" "error", "type" "not found", "statuscode" 404 } } 403 (forbidden) { "error" { "name" "error", "message" "forbidden", "reason" "error", "type" "bad request", "statuscode" "403" } } 500 (internal server error) { "error" { "name" "error", "message" "internal server error", "status" 500, "reason" "error", "type" "bad request", "statuscode" 500 } } 409(upstream down { "error" { "name" "error", "message" "error in fetching data from upstream please try again later ", "status" 409, "reason" "upstream error", "type" "conflict", "statuscode" 409 } } field type description name string text displayed on the screen explaining error type reason string reason for the error status number http status code message string error message indicating an upstream error type string error type statuscode number status code representing the error scenario 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!