Get signing documents
List (unarchived) signing documents. Use /status/ if you need high-level information.
Query Parameters
- group string required
Filter by a specific group, required.
- archived string
Filter on archived status, default is false
- email string
Filter by signer email
- limit integer
Default value:
20
Length of dataset to return. Use with offset query to iterate through results.
- offset integer
Offset from start of dataset. Use with the limit query to iterate through dataset.
- status integer
Filter on document status
- nosigners string
Add value '1' to remove signers information for a faster query
- created_gt date-time
Filter for those documents created after a certain time
- modified_gt date-time
Filter for those documents modified after a certain time
- 200
- 400
successful operation, list of document objects
- application/json
- Schema
- Example (from schema)
Schema
meta object
limit int32next stringoffset int32previous stringtotal_count int32total number of objects
objects object[]
archived booleanauto_archive booleancc_emails stringcreated date-timedo_email booleandownload_final booleangroup stringPossible values: Value must match regular expression
^/api/v1/group/[-\w]{1,50}/$
modified date-timename stringpdftext stringredirect stringresource_uri stringreturn_signer_links booleansigners array[]Possible values:
>= 8
,<= 8
nested arrays with signer details
signers_in_order int32Possible values:
non-empty
, [0
,1
]status integerPossible values: [
10
,20
,30
,40
,50
]Document status options:
- 10 - Initial state, check signer status for sent/unsent
- 20 - Fields completed
- 30 - Signed
- 40 - Removed (before signing)
- 50 - Rejected
tag stringPossible values: Value must match regular expression
^[-\w\[\]\:\;\/\.\, _]{0,250}$
tag1 stringPossible values: Value must match regular expression
^[-\w\[\]\:\;\/\.\, _]{0,250}$
tag2 stringPossible values: Value must match regular expression
^[-\w\[\]\:\;\/\.\, _]{0,250}$
template stringPossible values: Value must match regular expression
^/api/v1/template/[-\w]{1,60}/$
templatepdf stringPossible values: Value must match regular expression
^/api/v1/templatepdf/[-\w]{1,60}/$
text stringuser stringPossible values: Value must match regular expression
^/api/v1/user/[-\w]{1,60}/$
uuid uuid
{
"meta": {
"limit": 0,
"next": "string",
"offset": 0,
"previous": "string",
"total_count": 0
},
"objects": [
{
"archived": false,
"auto_archive": true,
"cc_emails": "None",
"created": "2020-05-20T:15:10",
"do_email": false,
"download_final": false,
"group": "/api/v1/group/my-group/",
"modified": "2020-05-20T:15:10",
"name": "test cs_agreement",
"pdftext": "None",
"redirect": "https://example.com/redirect-receive/",
"resource_uri": "/api/v1/document/d0d0d0d0-d0fd0-d0d0-d0d0-d0d0d0d0d0d0/",
"signers": [
"/api/v1/signers/s0s0s0s0-s0s0-s0s0-s0s0-s0s0s0s0s0s0/, Joe, Biggins, joe.biggins@widgets.com, '', true, 20, 0",
"/api/v1/signers/s1s1s1s1-s1s1-s1s1-s1s1-s1s1s1s1s1s1/, Betty, MacLean, betty.maclean@widgets.comma, '', true, 10, 1"
],
"signer_in_order": true,
"status": 10,
"tag": "contract2020myref",
"tag1": "my_other_ref",
"tag2": "andFinalRef",
"template": "None",
"templatepdf": "/api/v1/templatepdf/p0p0p0p0-p0p0-p0p0-p0p0-p0p0p0p0p0p0/",
"text": "",
"user": "/api/v1/user/u0u0u0u0-u0u0-u0u0-u0u0-u0u0u0u0u0u0/",
"uuid": "d0d0d0d0-d0fd0-d0d0-d0d0-d0d0d0d0d0d0"
}
]
}
Invalid status value