Skip to content

DocumentsSearchApi.md

Latest commit

 

History

History
94 lines (74 loc) · 6.17 KB

DocumentsSearchApi.md

File metadata and controls

94 lines (74 loc) · 6.17 KB

SignRequest.Api.DocumentsSearchApi

All URIs are relative to https://signrequest.com/api/v1

Method HTTP request Description
DocumentsSearchList GET /documents-search/ Search documents

DocumentsSearchList

InlineResponse2002 DocumentsSearchList (int? page = null, int? limit = null, string q = null, string autocomplete = null, string name = null, string subdomain = null, string signerEmails = null, string status = null, string who = null, string format = null, decimal? signerData = null)

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.

Example

using System;
using System.Diagnostics;
using SignRequest.Api;
using SignRequest.Client;
using SignRequest.Model;

namespace Example
{
    public class DocumentsSearchListExample
    {
        public void main()
        {
            // Configure API key authorization: Token
            Configuration.Default.AddApiKey("Authorization", "YOUR_API_KEY");
            Configuration.Default.AddApiKeyPrefix("Authorization", "Token");

            var apiInstance = new DocumentsSearchApi();
            var page = 56;  // int? | A page number within the paginated result set. (optional) 
            var limit = 56;  // int? | Number of results to return per page. (optional) 
            var q = q_example;  // string | Normal search query (optional) 
            var autocomplete = autocomplete_example;  // string | Partial search query (optional) 
            var name = name_example;  // string | Document name (optional) 
            var subdomain = subdomain_example;  // string |  (optional) 
            var signerEmails = signerEmails_example;  // string | Email needed to sign/approve (optional) 
            var status = status_example;  // string | `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 (optional) 
            var who = who_example;  // string | `m`: only me, `mo`: me and others, `o`: only others (optional) 
            var format = format_example;  // string | Export format, can be `json` (default), `csv`, or `xls` (optional) 
            var signerData = 8.14;  // decimal? | Set to `1` to export with each signer on a separate row (optional) 

            try
            {
                // Search documents
                InlineResponse2002 result = apiInstance.DocumentsSearchList(page, limit, q, autocomplete, name, subdomain, signerEmails, status, who, format, signerData);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling DocumentsSearchApi.DocumentsSearchList: " + e.Message );
            }
        }
    }
}

Parameters

Name Type Description Notes
page int? A page number within the paginated result set. [optional]
limit int? Number of results to return per page. [optional]
q string Normal search query [optional]
autocomplete string Partial search query [optional]
name string Document name [optional]
subdomain string [optional]
signerEmails string Email needed to sign/approve [optional]
status string `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 [optional]
who string `m`: only me, `mo`: me and others, `o`: only others [optional]
format string Export format, can be `json` (default), `csv`, or `xls` [optional]
signerData decimal? Set to `1` to export with each signer on a separate row [optional]

Return type

InlineResponse2002

Authorization

Token

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json, text/csv, application/vnd.ms-excel

[Back to top] [Back to API list] [Back to Model list] [Back to README]