Initiate Contract Query API

introduction welcome to the initiate contract query api this api serves as a powerful tool for conducting efficient database searches based on unique reference ids generated by the initiate contract api the goal is to streamline the retrieval of contract related information, utilizing a special uuid code (uniquereferenceid) given by clients for each request it has to be 36 characters long unique reference id (uniquereferenceid) passed by end clients to uniquely identify each request key features efficient searches conduct targeted searches within the database based on uniquereferenceid, ensuring rapid access to relevant data universal integration seamlessly integrate with existing systems, utilizing the uniquereferenceid as a consistent identifier across all transactions scalability and flexibility accommodate various contract management needs, from individual inquiries to bulk data retrieval, with scalability to support evolving requirements secure retrieval prioritize data security through robust authentication measures, ensuring authorized access to sensitive information harness the capabilities of the initiate contract query api to streamline contract management processes, enhance operational efficiency, and make informed decisions with confidence across finance, legal, and enterprise management domains authentication api authentication is a crucial security process that ensures authorized access to an application programming interface (api) it involves validating the identity of users or systems seeking to interact with the api please use the access token shared with you by your assigned signzy's csm please set the value of the key authorization in the headers to the access token , while making an api call in this way, signzy's system will be able to authenticate you and you will be able to make a successful api call api details the details of the api can be found here sample curl pre production curl location 'https //api preproduction signzy app/api/v3/contract/initiatequery' \\ \ header 'authorization ' \\ \ header 'content type application/json' \\ \ data '{ "x uniquereferenceid" "" }' production curl location 'https //api signzy app/api/v3/contract/initiatequery' \\ \ header 'authorization ' \\ \ header 'content type application/json' \\ \ data '{ "x uniquereferenceid" "" }' input parameters key description type mandatory/optional x uniquereferenceid unique reference id of the initiate contract api 36 characters long, uuid number which has to be unique for example, 82541a35 d494 4fbb 97f3 e2323208986e string mandatory sample response 200 { "contractid" "3c54deeb b91d 4893 8ec9 46573e85f45b", "initialsignercount" 2, "signedsignercount" 0, "deletedsignercount" 0, "contractname" "dd", "contractexecutername" "dd", "successredirecturl" "https //signzy com", "failureredirecturl" "https //google com", "callbackurl" "https //qa signzy xyz/callback/mohitposts", "signercallbackurl" "https //qa signzy xyz/callback/mohitposts", "contractttl" 10000, "initialcontract" "https //staging persist signzy tech/api/files/4879805/download/1a3018421e5b411687718238f8d045df60031ccea6404341a63c23d81aa29279 pdf", "initialcontracthash" "51acd08565171da3a2e1f50b600df06b444ff18204e53103d2ef590688a3a39a", "finalsignedcontract" "", "finalsignedcontracthash" "", "iscompleted" false, "contractcompletiontime" "", "estamp" { "transactionid" "64d9c218374c36670d994286", "estampstatus" "pending", "transactionresult" { "challanno" "nl0013", "challansubno" "nl0013 00001", "estampedfile" "https //staging persist signzy tech/api/files/4879805/download/1a3018421e5b411687718238f8d045df60031ccea6404341a63c23d81aa29279 pdf" } }, "signerdetail" \[ { "signername" "mohit", "signeremail" "", "signermobile" "", "signergender" "male", "signeryearofbirth" "0101", "signerid" "0ee176c4 39a1 4b9d 9923 85be82730ac4", "workflowurl" "", "signaturetype" "aadhaaresign otp", "additionalsignaturetypes" \[], "contractlastsigntime" "", "status" "draft", "errormessage" "", "contractsendtime" "wed may 29 2024 12 04 21 gmt+0530 (india standard time)", "aadhaarstatus" "", "aadhaarerrormessage" "", "matchscoreresult" {}, "signerip" "", "noofsuccessfulattempts" 0, "nooffailureattempts" 0, "signersignedcontract" "", "signersignedcontracthash" "", "esignattempts" \[] }, { "signername" "cdcdc", "signeremail" "", "signermobile" "", "signergender" "na", "signeryearofbirth" "0101", "signerid" "93b6308c 0adc 4c8a 85ff 7b307439d74b", "workflowurl" "", "signaturetype" "aadhaaresign otp", "additionalsignaturetypes" \[], "contractlastsigntime" "", "status" "pending", "contractsendtime" "wed may 29 2024 12 04 21 gmt+0530 (india standard time)", "aadhaarstatus" "", "errormessage" "", "aadhaarstatus" "", "aadhaarerrormessage" "", "matchscoreresult" {}, "signerip" "", "noofsuccessfulattempts" 0, "nooffailureattempts" 0, "signersignedcontract" "", "signersignedcontracthash" "", "esignattempts" \[ { "errormessage" "na", "aadhaarstatus" "1", "aadhaarerrormessage" "", "signerdscdata" { "state" "karnataka", "pincode" "", "dnqualifier" "", "yob" "", "gender" "male", "uidlastfourdigits" "", "x500uniqueidentifier" "", "aadhaartoken" "", "pseudonym" "", "aadhaartype" "personal", "country" "in", "name" "" } } ] } ], "deletedsignerdetail" \[], "x uniquereferenceid" "" } output parameters field name description type contractid unique identifier for the contract string initialsignercount number of initial signers for the contract number signedsignercount number of signers who have already signed the contract number deletedsignercount number of signers who have been deleted from the contract number contractname name of the contract string contractexecutername name of the contract executor string successredirecturl url to redirect after successful contract execution string failureredirecturl url to redirect in case of contract execution failure string callbackurl url for callback upon contract completion string signercallbackurl url for individual signer callbacks string contractttl time to live (in milliseconds) for the contract number initialcontract url to the initial contract document string initialcontracthash initial hash of the contract string finalsignedcontract url to the final signed contract document string finalsignedcontracthash hash of the final signed contract string iscompleted status indicating whether the contract is completed (true) or not (false) boolean contractcompletiontime timestamp indicating when the contract was completed string estamp electronic stamp details for the contract object signerdetail details of signers for the contract array of objects deletedsignerdetail details of deleted signers from the contract array of objects x uniquereferenceid unique reference id of the initiate contract api 36 characters long, uuid number which has to be unique for example, 82541a35 d494 4fbb 97f3 e2323208986e string estamp field name description type transactionid unique identifier for the estamp transaction string estampstatus status of the estamp transaction string transactionresult result details of the estamp transaction object transaction result (within estamp) field name description type challanno challan number for the estamp transaction string challansubno sub challan number for the estamp transaction string estampedfile url to the estamped contract document string signerdetail field name description type signername name of the signer string signeremail email id of the signer string signermobile mobile number of the signer string signergender gender of the signer string signeryearofbirth year of birth of the signer string signerid unique identifier for the signer string signaturetype type of signature for the signer string workflowurl signing url link string contractlastsigntime timestamp of the signer's last sign attempt string additionalsignaturetypes additional signature type methods string status status of the signer (e g , draft, pending) string errormessage error message related to the signer string aadhaarstatus aadhaar status of the signer string aadhaarerrormessage error message related to aadhaar verification string matchscoreresult result of match score for the signer object signerip ip address of the signer string noofsuccessfulattempts number of successful sign attempts by the signer number nooffailureattempts number of failed sign attempts by the signer number signersignedcontract url to the signer's signed contract document string signersignedcontracthash hash of the signer's signed contract string esignattempts details of e sign attempts by the signer array of objects esign attempts field name description type errormessage error message, if any string aadhaarstatus aadhaar status string aadhaarerrormessage error message related to aadhaar string signerdscdata object containing signer dsc data object signerdscdata state state information string signerdscdata pincode pincode information string signerdscdata dnqualifier distinguished name qualifier string signerdscdata yob year of birth string signerdscdata gender gender string signerdscdata uidlastfourdigits last four digits of uid string signerdscdata x500uniqueidentifier x 500 unique identifier string signerdscdata aadhaartoken aadhaar token string signerdscdata pseudonym pseudonym string signerdscdata aadhaartype type of aadhaar string signerdscdata country country string signerdscdata name name string sample errors 400 { "name" "error", "message" "x uniquereferenceid length must be 12 32 characters long", "reason" "validation error", "type" "bad request", "statuscode" 400 } 400 { "name" "error", "message" "x uniquereferenceid is not allowed to be empty", "reason" "validation error", "type" "bad request", "statuscode" 400 } 401 { "message" "invalid authentication credentials" } 404 { "name" "error", "message" "x uniquereferenceid not found", "reason" "not found", "type" "not found", "statuscode" 404 } 500 { "error" { "name" "error", "message" "internal server error", "reason" "internal server error", "type" "internal server error", "statuscode" 500 } } error parameters parameter type description name string in case of errors, it will have the value "error" it represents an error message string message for the error reason string reasons for the error type string type of error statuscode string status code of the error error codes error code error message explanation 400 bad request input parameter has a missing required parameter or invalid inputs 401 authorization failed authorization token is invalid 404 not found contract id eneterd is not found in the database 500 internal server error internal error at signzy, please reach out to help\@signzy com