v1
latestSwagger 2.02026-08-063530171.1 KBSearch documents
Search interface for fast (autocomplete) searching of documents.
This can be useful to have your users search for a document in your interface.
Document names are tokenized on whitespace, hyphens and underscores to also match partial document names.
Normal search:
- ?q={{query}}
Autocomplete search:
- ?autocomplete={{partial query}}
Search in document name:
- ?name={{query}}
Available (extra) filters:
- ?subdomain={{ team_subdomain }} or use this endpoint with team_subdomain.signrequest.com (when not provided only personal documents are shown)
- ?signer_emails={{ signer@email.com }} (will filter documents that an email needed to sign/approve)
- ?status={{ si }}
- ?who={{ mo }}
To include multiple values for a filter field separate the values with a pipe (|). For example to only search for completed documents use status=se|vi (sent and viewed).
Pagination:
- ?page={{ page_number: default 1 }}
- ?limit={{ limit results: default 10, max 100 }}
Format:
By default json is returned, to export data as csv or xls use the format parameter.
- ?format=csv
- ?format=xls
For csv and xls the data can also be exported with each signer on a separate row. In this mode also the signer inputs that have an external_id specified on a tag will be exported. All external_id's found will be exported as columns. To use this mode add the signer_data parameter.
- ?format=csv&signer_data=1
- ?format=xls&signer_data=1
Note that all documents are only ordered by created (newest first) when q, autocomplete or name are not used, else they are ordered by the strenght of the match.
Query parameters
A page number within the paginated result set.
Number of results to return per page.
Normal search query
Partial search query
Document name
Email needed to sign/approve
co: converting, ne: new, se: sent, vi: viewed, si: signed, do: downloaded, sd: signed and downloaded, ca: cancelled, de: declined, ec: error converting, es: error sending, xp: expired
m: only me, mo: me and others, o: only others
Export format, can be json (default), csv, or xls
Set to 1 to export with each signer on a separate row
Response
OK