searchRecords Method - Comparison

searchRecords Method - Comparison

Purpose

To search the values based on pre-defined columns.

Request URL

Version 1.0:

https://crm.zoho.com/crm/private/xml/Leads/searchRecords?authtoken=AuthToken&scope=crmapi&criteria=(((Last Name:Steve)AND(Company:Zillum))OR(Lead Status:Contacted))

Version 2.0:

URL: https://www.zohoapis.com/crm/v2/Leads/search?criteria=((Last_Name:starts_with:G) and (Email:equals:deborah@healthnet.com))

Method: GET

Header: Authorization=Zoho-oauthtoken {oauth_token}

Request Parameters

Version 1.0 Version 2.0
authtoken=**** Authorization=Zoho-oauthtoken ***** - as a Header.
scope=crmapi N/A
selectColumns==Leads(First Name,Last Name,Email,Company,Campaign Source) fields=First_Name,Last_Name,Email,Company
First_Name,Last_Name,Email,Company are field API names
fromIndex=1&toIndex=20 page=1&per_page=20
criteria=(((Last Name:Steve)AND(Company:Zillum))OR(Lead Status:Contacted)) criteria=(((Last_Name:equals:Steve) and (Company:equals:Zillum)) or (Lead_Status:equals:Contacted))
newFormat N/A
lastModifiedTime If-Modified-Since header
 

Sample API Request:

Request in Version 1.0 Request in Version 2.0
https://crm.zoho.com/crm/private/xml/Leads/
getSearchRecordsByPDC?authtoken=*****
&searchColumn=email&searchValue=email@zoho.com
URL - https://crm.zoho.com/crm/v2/Leads/search?criteria=(Email:equals:email@zoho.com)
 

Note:

The responses are similar to the getRecords API response.

    • Related Articles

    • searchRecords Method

       Purpose You can use the searchRecords method to get the list of records that meet your search criteria.  Request URL XML Format: https://crm.zoho.com/crm/private/xml/Leads/searchRecords?authtoken=Auth Token&scope=crmapi&criteria=(((Last ...
    • downloadPhoto Method - Comparison

      Purpose To download the photo of a lead or a contact. Request URL Version 1.0: https://crm.zoho.com/crm/private/xml/(Leads or Contacts)/downloadPhoto?authtoken=AuthToken&scope=crmapi&id=RecordID Version 2.0: URL: ...
    • downloadFile Method - Comparison

      Purpose To download a file attached to a record. Request URL Version 1.0: https://crm.zoho.com/crm/private/xml/Leads/downloadFile?authtoken=AuthToken&scope=crmapi&id=Attachment Id Version 2.0: URL: ...
    • deletePhoto Method - Comparison

      Purpose To delete a photo of a contact or lead. Request URL Version 1.0: https://crm.zoho.com/crm/private/xml/(Leads or Contacts)/deletePhoto?authtoken=AuthToken&scope=crmapi&id=RecordID Version 2.0: URL: https://www.zohoapis.com/crm/v2/{Leads or ...
    • deleteRecords Method - Comparison

      Purpose To delete the selected records. Request URL Version 1.0: https://crm.zoho.com/crm/private/xml/Leads/deleteRecords?authtoken=AuthToken&scope=crmapi&id=Record ID Version 2.0: URL: https://www.zohoapis.com/crm/v2/Leads/{record_id} Method: DELETE ...