Request Signature - Enadoc Sign

Document Sign Request

POST [ENADOC_URL]/api/v3/documents/{{documentToken}}/signatories

Use the above URL to request signature(s).

Path Parameters

Name	Type	Description
DocumentToken*	String	Document token

Headers

Name	Type	Description
Authorization*	String	Type - Bearer Access token will be sent in request headers
Content-Type*	String	multipart/related

Request Body

Name	Type	Description
Multipart-content*	String	Content-type - Application/Json Request body should contain Signatories values

200: OK If the request proceeds successfully, you will receive status code 200 with success message and signature token. Requester will get this message

{
    "responseMessage": "successfully submitted for signing process",
    "signatureToken": "2B97D2C93E0247CB9A4661EF432D63ED1587807B4DF94D31B6ACE2F313BEC6AF"
}

Use the following format for the request body

{
  "signatories": [
    {
      "id": 1,
      "order": 1
    },
    {
      "id": 2,
      "order": 2
    }
  ],
  "message": "Please sign on page 10",
  "callbackurl": "http://www.example.com/api/response",
  "IsActive": "true"
}

Please note that the above callback url is a sample url given for your information. Please use your application call back url.

Below response will be sent to your application call back url after signed by every signatory. Document token will be received only at the end of signing process. If else, you will receive empty value for document token at the rest of prior stages before end the process.

{
   "signaturetoken":"5B9DE8435D1241C0A2A4C3866806EE88CB10871AAF1145E3AB6A265F361D725C",
   "documentToken":"z2m1ve341o38MIRwnZFjhnY8LwNBNWqMprqMKA0ADMANKA2ADcANwAwADcANKP1ve3",
   "signatoryname":"[email protected]",
   "status":"Approved",
   "actionDate":"2021-21-12 08:15 AM"
}

To get list of users who can sign documents, use api/v3/users with the type parameter

[ENADOC_URL]/api/v3/users?type=signatories

Get Sign Process Status

GET [ENADOC_URL]/api/v3/documents/{{documentToken}}/signatories

Path Parameters

Name	Type	Description
DocumentToken*	String	Document token

Headers

Name	Type	Description
Authorization*	String	Type - Bearer Access token will be sent in request headers

200: OK If the request proceed successfully, you will receive status code 200 with the status of signing process

[
{
"respondedUserName": "[email protected]",
"level": 1,
"action": "SIGNED",
"actionDate": "Nov 12 2021 4:38PM"
},
{
"respondedUserName": "[email protected]",
"level": 2,
"action": "PENDING",
"actionDate": ""
}
]

You will get the response as below. Response consists of the details of all signing processes which is related with given document.

[
   {
      "signatureToken":"9C1396B5B29449B2A11C960838E11D87651D1B188BA44327AB3EE65378052ADA",
      "status":[
         {
            "respondedUserName":"[email protected]",
            "level":1,
            "action":"SIGNED",
            "actionDate":"2021-12-11 07:24 PM"
         },
         {
            "respondedUserName":"[email protected]",
            "level":2,
            "action":"SIGNED",
            "actionDate":"2021-12-11 07:25 PM"
         }
      ]
   }
]