Secured Signing API

<back to all web services

PackageExtendRequest

The following routes are available for this service:
POST/Package/ExtendExtend the package due dateExtend the package due date
PackageExtendRequest Parameters:
NameParameterData TypeRequiredDescription
PackageReferencemodelstringYesPackage reference
DueDatemodelstringYesThe ISO 8601 formats is the better way to pass the due date to API; otherwise API will try to parse the date string according to user's settings. If it can not be identified, an error will return
GMTmodelstringNoThe total minutes of the offset between your local time to UTC time. If it's not specified, user's settings will be applied. If the date is UTC time already, set it as 0.
PackageResponse Parameters:
NameParameterData TypeRequiredDescription
QueueReferenceformstringNo
PackageReferenceformstringNo
PackageNameformstringNo
PackageStatusformstringNo
DocumentsformList<DocumentResponse>No
DocumentResponse Parameters:
NameParameterData TypeRequiredDescription
NameformstringYesFile Name
FormDirectReferenceformstringNoForm reference
SignersformarrayYesList of signers
StatusformstringNoDocument signing status

Allowable Values

  • Complete
  • Declined
  • Expired
  • Rejected
  • Signed
  • Filling
  • Filling Form
  • InProgress
  • Signing
  • NotStart
  • # of # Signed
DueDateformstringNoDue Date of document
GMTformstringNoGMT Offset
LastSignedDateformstringNoDate of latest signature
FolderformstringNoThe folder of the document

Allowable Values

  • InBox
  • Progress
  • Signed
LogsformarrayNoDocument logs
HasFileUploadedformbooleanNoWhether invitee uploaded any files during signing process.
PackageReferenceformstringNoPackage reference
ClientReferenceformstringNoclient side referese; e.g. external id etc.
EditUrlformstringNo
IDVerificationRequestedformboolNoID Verification requested.
MatterNumberformstringNoMatter Number
DocumentReferenceResponse Parameters:
NameParameterData TypeRequiredDescription
ReferenceformstringYesDocument reference, used for document access
SignerStatusResponse Parameters:
NameParameterData TypeRequiredDescription
HasSignedformbooleanNoUser signing status
EditableformbooleanNoSigner name and email can be updated by Calling UpdateSigner
SignedStatusformbooleanNoSigner Status

Allowable Values

  • Initialized
  • Invitation
  • Reminder1
  • Reminder2
  • AutoExtend
  • Expired
  • Signed
  • Complete
  • Archived
  • Pending
  • Deleted
  • Rejected
  • Declined
  • Reminder
DeclinedReasonformstringNoDeclined reason. Return only when invitee declined to sign.
VideoConfirmationDetailformVideoConfirmationDetailNo
IDCheckStatusformstringNo
IDVerificationStatusformstringNo
IDVerificationResultformstringNo
IDVerificationFaceMatchResultformstringNo
IDVerificationLivenessResultformstringNo
SignerResponse Parameters:
NameParameterData TypeRequiredDescription
SigningKeyformstringNoUrl for access to signing; Only when this is an embedded signer
Signer Parameters:
NameParameterData TypeRequiredDescription
SignerReferenceformstringNoSigner reference
IsFaceToFaceSigningformboolNo
VideoConfirmationEnabledformboolNo
ReviewBeforeSigningEnabledformboolNo
Invitee Parameters:
NameParameterData TypeRequiredDescription
MobileNumberformstringNoMobile number of signer, for SMS secured forms. Must include the mobile carrier code e.g. Australia 04, New Zealand 027 or 021 etc
MobileCountryformstringNoMobile Country code for phone number e.g. Australia 61, New Zealand 64 etc
ShareUsersformList<ShareUser>No
ClientReferenceformstringNo
UserInfo Parameters:
NameParameterData TypeRequiredDescription
FirstNameformstringYesFirst name of user
MiddleNameformstringNoMiddle name of user
LastNameformstringYesLast name of user
EmailformstringYesEmail address of user
ShareUser Parameters:
NameParameterData TypeRequiredDescription
IsDefaultformboolNo
IsOwnerformboolNo
SignedStatus Enum:
Initialized
Invitation
Reminder1
Reminder2
AutoExtend
Expired
Signed
Complete
Archived
Pending
Deleted
Rejected
Declined
Reminder
VideoConfirmationDetail Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
ShortUrlformstringNo
IsVideoReadyformboolNo
PasswordformstringNo
EmailformstringNo
IsWitnessformboolNo
IsVideoDisabledformboolNo
IsVideoOptOutformboolNo
WitnessOwnerformstringNo
DocumentLog Parameters:
NameParameterData TypeRequiredDescription
NameformstringNoName of user responsible for action
ActionformstringNoLog entry
DateformstringNoDate of log entry
GMTformstringNoGMT Offset
RoleformstringNoRole of user responsible for action

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /Package/Extend HTTP/1.1 
Host: api.securedsigning.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PackageExtendRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Requests">
  <DueDate>String</DueDate>
  <GMT>String</GMT>
  <PackageReference>String</PackageReference>
</PackageExtendRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<PackageResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Models">
  <Documents>
    <DocumentResponse>
      <Reference>String</Reference>
      <ClientReference>String</ClientReference>
      <DueDate>String</DueDate>
      <EditUrl>String</EditUrl>
      <Folder>String</Folder>
      <FormDirectReference>String</FormDirectReference>
      <GMT>String</GMT>
      <HasFileUploaded>false</HasFileUploaded>
      <IDVerificationRequested>false</IDVerificationRequested>
      <LastSignedDate>String</LastSignedDate>
      <Logs>
        <DocumentLog>
          <Action>String</Action>
          <Date>String</Date>
          <GMT>String</GMT>
          <Name>String</Name>
          <Role>String</Role>
        </DocumentLog>
      </Logs>
      <MatterNumber>String</MatterNumber>
      <Name>String</Name>
      <PackageReference>String</PackageReference>
      <Signers>
        <SignerStatusResponse>
          <Email>String</Email>
          <FirstName>String</FirstName>
          <LastName>String</LastName>
          <MiddleName>String</MiddleName>
          <ClientReference>String</ClientReference>
          <MobileCountry>String</MobileCountry>
          <MobileNumber>String</MobileNumber>
          <ShareUsers>
            <ShareUser>
              <Email>String</Email>
              <FirstName>String</FirstName>
              <LastName>String</LastName>
              <MiddleName>String</MiddleName>
              <IsDefault>false</IsDefault>
              <IsOwner>false</IsOwner>
            </ShareUser>
          </ShareUsers>
          <IsFaceToFaceSigning>false</IsFaceToFaceSigning>
          <ReviewBeforeSigningEnabled>false</ReviewBeforeSigningEnabled>
          <SignerReference>String</SignerReference>
          <VideoConfirmationEnabled>false</VideoConfirmationEnabled>
          <SigningKey>String</SigningKey>
          <DeclinedReason>String</DeclinedReason>
          <Editable>false</Editable>
          <HasSigned>false</HasSigned>
          <IDCheckStatus>String</IDCheckStatus>
          <IDVerificationFaceMatchResult>String</IDVerificationFaceMatchResult>
          <IDVerificationLivenessResult>String</IDVerificationLivenessResult>
          <IDVerificationResult>String</IDVerificationResult>
          <IDVerificationStatus>String</IDVerificationStatus>
          <SignedStatus>Initialized</SignedStatus>
          <VideoConfirmationDetail>
            <Email>String</Email>
            <IsVideoDisabled>false</IsVideoDisabled>
            <IsVideoOptOut>false</IsVideoOptOut>
            <IsVideoReady>false</IsVideoReady>
            <IsWitness>false</IsWitness>
            <Name>String</Name>
            <Password>String</Password>
            <ShortUrl>String</ShortUrl>
            <WitnessOwner>String</WitnessOwner>
          </VideoConfirmationDetail>
        </SignerStatusResponse>
      </Signers>
      <Status>String</Status>
    </DocumentResponse>
  </Documents>
  <PackageName>String</PackageName>
  <PackageReference>String</PackageReference>
  <PackageStatus>String</PackageStatus>
  <QueueReference>String</QueueReference>
</PackageResponse>