| POST | /FormFiller/Send | Send the template(s) to invitees to start a We Sign process | Send a template for filling and signing |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Templates | model | array | Yes | Collection of forms to be sent, if an account reference is not supplied for the forms, the forms will be associated with your api account. |
| DueDate | model | string | No | Due date that forms are to be signed by. If not set, +14 days is the default |
| GMT | model | string | No | GMT Offset |
| Embedded | model | boolean | No | Shows if embedded signing |
| ReturnUrl | model | string | No | Return Url |
| Sequential | model | boolean | No | If all signers need to sign one by one with the order in template.signers |
| NotifyUrl | model | string | No | Notify Url |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | Yes | Template name |
| Reference | form | string | Yes | Identifier |
| Signers | form | array | Yes | List of signers required for the template |
| Fields | form | array | Yes | List of fields required for the template |
| ClientReference | form | string | No | client side referese; e.g. external id etc. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| SignerReference | form | string | No | Signer reference |
| IsFaceToFaceSigning | form | bool | No | |
| VideoConfirmationEnabled | form | bool | No | |
| VideoConfirmationDeepfakeEnabled | form | bool | No | |
| ReviewBeforeSigningEnabled | form | bool | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| MobileNumber | form | string | No | Mobile number of signer, for SMS secured forms. Must include the mobile carrier code e.g. Australia 04, New Zealand 027 or 021 etc |
| MobileCountry | form | string | No | Mobile Country code for phone number e.g. Australia 61, New Zealand 64 etc |
| ShareUsers | form | List<ShareUser> | No | |
| ClientReference | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| FirstName | form | string | Yes | First name of user |
| MiddleName | form | string | No | Middle name of user |
| LastName | form | string | Yes | Last name of user |
| form | string | Yes | Email address of user |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| IsDefault | form | bool | No | |
| IsOwner | form | bool | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Label | form | string | Yes | Field label |
| Value | form | string | Yes | Field value |
| FieldType | form | string | Yes | Field typeAllowable Values
|
| IsRequired | form | boolean | Yes | If field is mandatory |
| ID | form | string | Yes | Field reference; Obsolated, use Reference instead. |
| Reference | form | string | Yes | Field reference; |
| ReadOnly | form | boolean | Yes | If field is readonly |
| ClientField | form | boolean | Yes | Field name on client side |
| Name | Value | |
|---|---|---|
| Text | 0 | |
| MultiLineText | 1 | |
| CheckBox | 3 | |
| RadioButton | 4 | |
| DropDownList | 5 | |
| DateInput | 6 |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| QueueReference | form | string | No | |
| PackageReference | form | string | No | |
| PackageName | form | string | No | |
| PackageStatus | form | string | No | |
| Documents | form | List<DocumentResponse> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | Yes | File Name |
| FormDirectReference | form | string | No | Form reference |
| Signers | form | array | Yes | List of signers |
| Status | form | string | No | Document signing statusAllowable Values
|
| DueDate | form | string | No | Due Date of document |
| GMT | form | string | No | GMT Offset |
| LastSignedDate | form | string | No | Date of latest signature |
| Folder | form | string | No | The folder of the documentAllowable Values
|
| Logs | form | array | No | Document logs |
| HasFileUploaded | form | boolean | No | Whether invitee uploaded any files during signing process. |
| PackageReference | form | string | No | Package reference |
| ClientReference | form | string | No | client side referese; e.g. external id etc. |
| EditUrl | form | string | No | |
| IDVerificationRequested | form | bool | No | ID Verification requested. |
| MatterNumber | form | string | No | Matter Number |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Reference | form | string | Yes | Document reference, used for document access |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| HasSigned | form | boolean | No | User signing status |
| Editable | form | boolean | No | Signer name and email can be updated by Calling UpdateSigner |
| SignedStatus | form | boolean | No | Signer StatusAllowable Values
|
| DeclinedReason | form | string | No | Declined reason. Return only when invitee declined to sign. |
| VideoConfirmationDetail | form | VideoConfirmationDetail | No | |
| IDCheckStatus | form | string | No | |
| IDVerificationStatus | form | string | No | |
| IDVerificationResult | form | string | No | |
| IDVerificationFaceMatchResult | form | string | No | |
| IDVerificationLivenessResult | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| SigningKey | form | string | No | Url for access to signing; Only when this is an embedded signer |
| Initialized | |
| Invitation | |
| Reminder1 | |
| Reminder2 | |
| AutoExtend | |
| Expired | |
| Signed | |
| Complete | |
| Archived | |
| Pending | |
| Deleted | |
| Rejected | |
| Declined | |
| Reminder |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | No | |
| ShortUrl | form | string | No | |
| IsVideoReady | form | bool | No | |
| Password | form | string | No | |
| form | string | No | ||
| IsWitness | form | bool | No | |
| IsVideoDisabled | form | bool | No | |
| IsVideoOptOut | form | bool | No | |
| WitnessOwner | form | string | No | |
| IsVideoConfirmationDeepfake | form | bool | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | No | Name of user responsible for action |
| Action | form | string | No | Log entry |
| Date | form | string | No | Date of log entry |
| GMT | form | string | No | GMT Offset |
| Role | form | string | No | Role 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
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /FormFiller/Send HTTP/1.1
Host: api.securedsigning.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<SendFormFillerRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Requests">
<DueDate>String</DueDate>
<Embedded>false</Embedded>
<GMT>String</GMT>
<NotifyUrl>String</NotifyUrl>
<ReturnUrl>String</ReturnUrl>
<Sequential>false</Sequential>
<Templates xmlns:d2p1="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Models">
<d2p1:FormFillerTemplate>
<d2p1:ClientReference>String</d2p1:ClientReference>
<d2p1:Fields>
<d2p1:FormFillerField>
<d2p1:ClientField>String</d2p1:ClientField>
<d2p1:FieldType>Text</d2p1:FieldType>
<d2p1:ID>String</d2p1:ID>
<d2p1:IsRequired>false</d2p1:IsRequired>
<d2p1:Label>String</d2p1:Label>
<d2p1:ReadOnly>false</d2p1:ReadOnly>
<d2p1:Reference>String</d2p1:Reference>
<d2p1:Value>String</d2p1:Value>
</d2p1:FormFillerField>
</d2p1:Fields>
<d2p1:Name>String</d2p1:Name>
<d2p1:Reference>String</d2p1:Reference>
<d2p1:Signers>
<d2p1:Signer>
<d2p1:Email>String</d2p1:Email>
<d2p1:FirstName>String</d2p1:FirstName>
<d2p1:LastName>String</d2p1:LastName>
<d2p1:MiddleName>String</d2p1:MiddleName>
<d2p1:ClientReference>String</d2p1:ClientReference>
<d2p1:MobileCountry>String</d2p1:MobileCountry>
<d2p1:MobileNumber>String</d2p1:MobileNumber>
<d2p1:ShareUsers>
<d2p1:ShareUser>
<d2p1:Email>String</d2p1:Email>
<d2p1:FirstName>String</d2p1:FirstName>
<d2p1:LastName>String</d2p1:LastName>
<d2p1:MiddleName>String</d2p1:MiddleName>
<d2p1:IsDefault>false</d2p1:IsDefault>
<d2p1:IsOwner>false</d2p1:IsOwner>
</d2p1:ShareUser>
</d2p1:ShareUsers>
<d2p1:IsFaceToFaceSigning>false</d2p1:IsFaceToFaceSigning>
<d2p1:ReviewBeforeSigningEnabled>false</d2p1:ReviewBeforeSigningEnabled>
<d2p1:SignerReference>String</d2p1:SignerReference>
<d2p1:VideoConfirmationDeepfakeEnabled>false</d2p1:VideoConfirmationDeepfakeEnabled>
<d2p1:VideoConfirmationEnabled>false</d2p1:VideoConfirmationEnabled>
</d2p1:Signer>
</d2p1:Signers>
</d2p1:FormFillerTemplate>
</Templates>
</SendFormFillerRequest>
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>
<VideoConfirmationDeepfakeEnabled>false</VideoConfirmationDeepfakeEnabled>
<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>
<IsVideoConfirmationDeepfake>false</IsVideoConfirmationDeepfake>
<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>