Authentication

SadqAuthorize

Request Headers

Authorization (required)

Bearer {token}

Content-Type (required)

application/json

Request Body

Content-Type: application/json

fileName (string, required)

Name of the PDF file to be signed

fileContent (string, required)

Base64 encoded content of the PDF file

referenceNumber (string, optional)

Optional reference number for tracking

signres (array, required)

List of signers information

addAuditTrail (boolean, required)

Include audit trail file in response

{
  "fileName": "string (required)",
  "fileContent": "string (required, base64)",
  "referenceNumber": "string (optional)",
  "signres": [
    {
      "firstNameArabic": "string",
      "firstNameEnglish": "string",
      "secondNameArabic": "string",
      "secondNameEnglish": "string",
      "familyNameArabic": "string",
      "familyNameEnglish": "string",
      "nationalId": "string",
      "mobileNumber": "string",
      "emailAddress": "string",
      "authType": "string ",
      "appearance": {
        "isVisible": "boolean (default: true)",
        "pageNumber": "string (default: 1)",
        "fontSize": "number (default: 8)",
        "x1": "number",
        "y1": "number",
        "width": "number",
        "height": "number",
        "appearanceImageBase64": "string (optional)",
        "imageLocation": "number (0 or 1)"
      }
    }
  ],
  "addAuditTrail": "boolean (required)"
}

Responses

{
  "errorCode": "number",
  "message": "string",
  "data": {
    "documentId": "guid",
    "envelopeId": "guid",
    "referenceNumber": "string",
    "signedFile": "string (base64)",
    "auditTrailFile": "string (base64, nullable)",
    "hasAuditTrail": "boolean",
    "isAuditTrailSeparate": "boolean"
  }
}