Searching for Records

the integration web service provides several options to search for records in a tenant the following table summarizes the four web methods providing for searching records \<font color="#ffffff">web method\</font>\<font color="#ffffff">applicability\</font> search general purpose web method for searching for records using an arbitrary query criteria use this web method if you cannot use the four web methods below to express the desired query criteria paginationsearch general purpose web method for searching for restricted number of records using an arbitrary query criteria use this web method if you cannot use the below three web methods below to express the desired query criteria findbusinessobject searches for the business object record by its recid field value in the database since records are uniquely identified by the recid (the primary key), this web method returns exactly one record, assuming the provided recid matches one of the existing records in the business object if you do not have the recid of the record to search for available, use another web method findsinglebusinessobjectbyfield searches for the business object record by the provided field or value criteria, and returns the exact record match, if it can be found for example, use this web method to identify an employee record, by either the loginid or primaryemail field (if the field values for the column are unique in the database table) this web method returns exactly one matching record, if it can be located if the search returns multiple records, it does not return any results if you are unsure if multiple results will be returned, use either the findmultiplebusinessobjectsbyfield or findbusinessobject web methods findmultiplebusinessobjectsbyfield searches for the business object record by the provided field or value criteria, and returns all of the results in an array for example, use this web method to identify all of the incident records with a status of resolved this webmethod returns one or more matching results in an array if you know that the search criteria will return exactly one record, the findsinglebusinessobjectbyfield web method provides a more convenient way of accessing the record directly (you can still use this web method and retrieve the record via the first item in the array ) the findbusinessobject , findsinglebusinessobjectbyfield , and findmultiplebusinessobjectsbyfield web methods are all special cases of the search web method the latter web method can be used to express any arbitrarily complex query this topic contains the following subtopics using the findbusinessobject web method docid\ iknjk5 elr rrx 9visa4using the findsinglebusinessobjectbyfield web method docid\ ecj gv7lubujtid90sq busing the findmultiplebusinessobjectsbyfield web method docid\ ok9hdineoxuiovaok1spsusing the search web method docid\ lvexuhezpxztbixn6qrlbusing the paginationsearch web method docid 3zvznx3wkn1ms4jxnno3qunderstanding the search results docid\ fk2go6ofqplvvovxpbo7n