| POST | /FormDirect/SendForms | Starts Form Direct Process | Send a package of forms for filling and signing |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Forms | 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 |
| InvitationEmailTemplateReference | form | string | No | |
| ListItems | form | List<DropDownListItem> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | Yes | Form name |
| FormType | form | integer | Yes | Form type |
| Reference | form | string | Yes | Form reference |
| Signers | form | object | Yes | List of signers required for the form |
| EmbedForm | form | boolean | Yes | If true, the signing links will be used in an iFrame to access the forms |
| ReturnUrl | form | string | No | After signing a form, the page will redirect to the specified url |
| NotifyUrl | form | string | No | Notify Url |
| XMLData | form | string | No | Auto fill data for the form. It is an XML document converted to a string. Secured Signing creates the template for the data. |
| EmployerReference | form | string | No | Auto fill employer data for the form. It can be returned by FormDirect/Employers api. Secured Signing creates the template for the data. |
| ClientReference | form | string | No | client side referese; e.g. external id etc. |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| SignerType | form | string | No | Role of invitee in signing process |
| UseIDData | form | boolean | No | When the use of a mobile phone is required for authencation but is not available, enable this option to use known data about the signer they have to use to ID themselves |
| IDData | form | AuthInfo | No | Data required for identifying signers with no access to mobile phones |
| EnabledFaceToFaceSigning | form | boolean | No | If enable face to face signing for this signer or not |
| Optional | form | boolean | No | When the signer can be optional, tell API this signer is ignored or not. |
| VideoConfirmation | form | boolean | No | If enable video confirmation for this signer or not |
| 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 | Description of the information required |
| Value | form | string | Yes | Value to be matched by invitee |
| DataType | form | string | Yes | Data typeAllowable Values
|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ClientField | form | string | Yes | The field name on client side |
| Item | form | string | Yes | Item name |
| Value | form | string | Yes | Item value |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /FormDirect/SendForms HTTP/1.1
Host: api.securedsigning.com
Accept: application/json
Content-Type: application/json
Content-Length: length
{"Forms":[{"Name":"String","FormType":0,"Reference":"String","Signers":[{"SignerType":"String","UseIDData":false,"IDData":[{"Label":"String","Value":"String","DataType":"String"}],"EnabledFaceToFaceSigning":false,"Optional":false,"VideoConfirmation":false,"MobileNumber":"String","MobileCountry":"String","ShareUsers":[{"IsDefault":false,"IsOwner":false,"FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"ClientReference":"String","FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"EmbedForm":false,"ReturnUrl":"String","NotifyUrl":"String","XMLData":"String","EmployerReference":"String","ClientReference":"String"}],"DueDate":"String","GMT":"String","InvitationEmailTemplateReference":"String","ListItems":[{"ClientField":"String","Item":"String","Value":"String"}]}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length
[{"Name":"String","FormDirectReference":"String","Signers":[{"HasSigned":false,"Editable":false,"SignedStatus":"Initialized","DeclinedReason":"String","VideoConfirmationDetail":{"Name":"String","ShortUrl":"String","IsVideoReady":false,"Password":"String","Email":"String","IsWitness":false,"IsVideoDisabled":false,"IsVideoOptOut":false,"WitnessOwner":"String"},"IDCheckStatus":"String","IDVerificationStatus":"String","IDVerificationResult":"String","IDVerificationFaceMatchResult":"String","IDVerificationLivenessResult":"String","SigningKey":"String","SignerReference":"String","IsFaceToFaceSigning":false,"VideoConfirmationEnabled":false,"ReviewBeforeSigningEnabled":false,"MobileNumber":"String","MobileCountry":"String","ShareUsers":[{"IsDefault":false,"IsOwner":false,"FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"ClientReference":"String","FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"Status":"String","DueDate":"String","GMT":"String","LastSignedDate":"String","Folder":"String","Logs":[{"Name":"String","Action":"String","Date":"String","GMT":"String","Role":"String"}],"HasFileUploaded":false,"PackageReference":"String","ClientReference":"String","EditUrl":"String","IDVerificationRequested":false,"MatterNumber":"String","Reference":"String"}]