List Contacts By Ids

GET {{baseUrl}}/api/v1/contacts/contactsByIds?ids=<long>

This API lists details of specific contacts, based on the IDs passed in the request.

OAuth Scope

  • Desk.contacts.READ

Request Params

KeyDatatypeRequiredDescription
idsstringList of Contact Ids (separated by comma) which must be fetched. The maximum number of IDs allowed is 20.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;lastName&quot;:&quot;Case&quot;,&quot;secondaryEmail&quot;:null,&quot;mobile&quot;:&quot;+91 8508569683&quot;,&quot;ownerId&quot;:null,&quot;type&quot;:null,&quot;accountId&quot;:&quot;1892000000091433&quot;,&quot;firstName&quot;:&quot;Jonathan&quot;,&quot;photoURL&quot;:&quot;https://desk.zoho.com/api/v1/contacts/1892000000772003/photo&quot;,&quot;isAnonymous&quot;:false,&quot;phone&quot;:&quot;1 888 900 9646&quot;,&quot;webUrl&quot;:&quot;https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38&quot;,&quot;createdTime&quot;:&quot;2017-10-12T13:11:50.000Z&quot;,&quot;isEndUser&quot;:false,&quot;zohoCRMContact&quot;:null,&quot;id&quot;:&quot;1892000000772003&quot;,&quot;isSpam&quot;:false,&quot;customerHappiness&quot;:{&quot;badPercentage&quot;:&quot;0&quot;,&quot;okPercentage&quot;:&quot;0&quot;,&quot;goodPercentage&quot;:&quot;0&quot;},&quot;email&quot;:&quot;case@zylker.com&quot;},{&quot;lastName&quot;:&quot;Jade&quot;,&quot;secondaryEmail&quot;:null,&quot;mobile&quot;:null,&quot;ownerId&quot;:null,&quot;type&quot;:null,&quot;accountId&quot;:&quot;1892000000052077&quot;,&quot;firstName&quot;:&quot;Christ&quot;,&quot;photoURL&quot;:null,&quot;isAnonymous&quot;:false,&quot;phone&quot;:null,&quot;webUrl&quot;:&quot;https://desk.zoho.com/support/zylker/ShowHomePage.do#Contacts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38&quot;,&quot;createdTime&quot;:&quot;2017-10-12T13:11:50.000Z&quot;,&quot;isEndUser&quot;:false,&quot;zohoCRMContact&quot;:{&quot;id&quot;:&quot;1892000000772030&quot;,&quot;type&quot;:&quot;contacts_leads&quot;},&quot;id&quot;:&quot;1892000000772001&quot;,&quot;customerHappiness&quot;:{&quot;badPercentage&quot;:&quot;22&quot;,&quot;okPercentage&quot;:&quot;31&quot;,&quot;goodPercentage&quot;:&quot;47&quot;},&quot;isSpam&quot;:false,&quot;email&quot;:&quot;jade@zylker.com&quot;}]}