v1

latestSwagger 2.02026-08-063530171.1 KB
documents-search

Search 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.

get/documents-search/

Query parameters

pageinteger

A page number within the paginated result set.

limitinteger

Number of results to return per page.

qstring

Normal search query

autocompletestring

Partial search query

namestring

Document name

subdomainstring
signer_emailsstring

Email needed to sign/approve

statusstring

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

whostring

m: only me, mo: me and others, o: only others

formatstring

Export format, can be json (default), csv, or xls

signer_datanumber

Set to 1 to export with each signer on a separate row

Response

OK

countinteger required
nextstring uri nullable
previousstring uri nullable