Page tree
Skip to end of metadata
Go to start of metadata

This article describes how to create a signing request for several persons to sign documents.

If only one person is to sign the documents, then use the command POST /sign instead. For more information, see Sign document with PDF Signing API

Create signing request step-by-step

  1. The web application sends a signing request to Nexus GO, including the documents, a list of signers and signing methods and a response URL.
    1. Nexus GO sends an email to each signer.
    2. Each signer clicks the link in the email and signs the request in the PDF Signing portal with the required method. 
    3. When all the signers have signed the request, Nexus GO signs the documents and sends a callback to the specified response URL. 
  2. When the signing state is COMPLETED, the web application requests the documents from Nexus GO. For more information, see Get request status or signed document.
    1. Nexus GO returns the documents including the signatures of all signers. 

Code example

To create a signing request with documents and signers, use the method POST /request. The access token that was received from the authentication must be included in the Header. For more information, see Authenticate to the PDF Signing API

When used in your own application, you must provide a valid response URL for the callback response.

 Example: Create sign request
Example: Create sign request
Authorization: Bearer <access token>
POST /request
{
  "documents": [
    {
      "name": "API.pdf",
      "data": "<base64 encoded pdf document>"
    }
  ],
 "onBehalfOf": "Nexus GO documentation",
  "name": "API documentation sample",
  "description": "Sample API for Nexus Go Signing",
  "responseUrl": "https://yourdomain.com/api/signing/callback",
  "signBefore": 14,
  "signers": [
    {
      "method": "PM",
      "signerEmail": "signer.pm@example.com"
    },
    {
      "method": "SE_BANKID",
      "signerEmail": "signer.bankid@example.com"
    }
  ]
}
Response
{
  "id":"123"
}
 Example: Callback from sign request
Example of request status update sent to the response URL
POST /response
{
  "id": "123",
  "name": "Request 1",
  "created": 1525843503909,
  "state": "COMPLETED"
}

For more information on how to get the status of the request or the actual documents, see Get request status or signed document.