Socotra
API Reference

Search API

ActionEndpoint
Fetch Search ResultsPOST/search/{tenantLocator}/search
Fetch Additional Search Results By TokenGET/search/{tenantLocator}/search

In addition to the read permission, you will need the policies.list, quotes.list, or accounts.list permission to be able to execute a search on the respective entity type.

Fetch Search Results

Fetch Search ResultsfetchSearchResults
POST/search/{tenantLocator}/search

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:search
Permission:
read

Fetch Additional Search Results By Token

Fetch Additional Search Results By TokenfetchAdditionalSearchResultsByToken
GET/search/{tenantLocator}/search

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
searchTokenquerystringYesThe token returned from the initial search
Security Group:search
Permission:
read
SearchRequest

Required properties

PropertyTypeDescription
searchEntityTypeEnum unspecified | account | quote | policy | fnol | contact | diary | payment | task | userAssociation
searchStringstring
fieldsstring[]
searchTermsSearchTermRequest[]

Optional properties

PropertyTypeDescription
endCreationTimedatetime?
sortFieldstring?
startCreationTimedatetime?
SearchTermRequest

Required properties

PropertyTypeDescription
fieldNamestring
absoluteEnum none | required | excluded
matchEnum fuzzy | exact | startsWith | lessThan | greaterThan
searchTermstring
SearchServiceResponse

Required properties

PropertyTypeDescription
countinteger
offsetinteger
searchTokenstring
resultsSearchResultResponse[]
SearchResultResponse

Required properties

PropertyTypeDescription
accountLocatorstring
configVersionLocatorstring
searchEntityLocatorulid
productNamestring
scorenumber
searchEntityTypeEnum unspecified | account | quote | policy | fnol | contact | diary | payment | task | userAssociation
highlightsstring[]
searchSummarymap<string, object>

See Also

On this page