Follow

ValidateDocument

Last updated 2016-08-11 13:16:51 UTC

The ValidateDocument operation can be used to validate a PDF document that was signed using AssureSign to ensure that it has not been tampered with.

This operation requires the binary data of the pdf file document formatted as a Base64 encoded string.

The result from the operation will contain the following attributes:

  • Code - a machine-readable result code indicating the result of the document validation operation
  • DocumentName - the name of the document when it was created in AssureSign
  • Originator - the name of the user that originated the document
  • OriginatingCompany - the account-setting defined name of the company that originated the document
  • DateCompleted - the date when document signing was completed
  • Description - a human-readable description of the result of the document validation operation

The possible values for the result code include the following:

  • COV - Completed and valid
  • COI - Completed, but invalid (may have been tampered with)
  • INC - Incomplete
  • CAN - Cancelled
  • DCN - Declined
  • EXP - Expired
  • DFI - Originated in a different instance of AssureSign
  • NMD - No matching document found
  • NAS - Not an AssureSign document
  • CPT - Document is corrupt
  • EGA - Error extracting AssureSign metadata attributes
  • ERL - Error loading document

Sample XML

<?xml version="1.0" encoding="utf-8"?> 
<ValidateDocument xmlns="https://www.assuresign.net/Services/DocumentNOW/ValidateDocument">
  <ValidateDocumentQuery>
    <FileDocument FileType="PDF">
      <Data>ZGF0YQ==</Data>
    </FileDocument>
  </ValidateDocumentQuery>
</ValidateDocument>

The SOAP Action header is

https://www.assuresign.net/Services/DocumentNOW/ValidateDocument/IValidateDocumentService/ValidateDocument

A response will return a single document validation result:

<?xml version="1.0" encoding="utf-8"?> 
<ValidateDocumentResponse xmlns="https://www.assuresign.net/Services/DocumentNOW/ValidateDocument">
  <ValidateDocumentQueryResult>
    <ValidationResult Code="COV" DocumentName="Test Document" Originator="John Doe" OriginatingCompany="ABC Company" DateCompleted="2012-05-30 12:47:41 (UTC)" Description="The document you uploaded was recognized as an AssureSign document and no indication was found that it has been tampered with." />
  </ValidateDocumentQueryResult>
</ValidateDocumentResponse>

The ValidateDocumentQueryResult should be checked for the presence of an Exceptions element, which may contain multiple ValidateDocumentException items.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.