Search for Channel Partners

Returns a list of channel partners for the provided query parameters.

Method Type URI
GET

v90/ws/partner.ws
?partnerName={partnerName}
&crmId={crmId}
&refId={refId}
&pageIndex={pageIndex}
&pageSize={pageSize}
&sortCol={sortCol}
&sortOrder={sortOrder}
&vendorId={vendorId}

Example URL: http://hostname:8080/ems/v90/ws/partner.ws?partnerName=ABCINC &crmId=crm34&refId=CRMN554&pageIndex=5&pageSize=10&sortCol=partnerName&sortOrder=asc&vendorId=2

URI Parameters

Parameter Description Type
crmId (Optional) CRM ID. String
refId (Optional) Reference ID. String
pageIndex (Optional) The starting page number. Integer (>0)
pageSize (Optional) The number of partners retrieved per request. Integer (>0)
partnerName (Optional) The channel partner name. String
sortCol (Optional) Sort against the column. String (crmId, partnerId, partnerName, refId, type)
sortOrder (Optional) The order to sort. String (asc, desc)
vendorId (Optional) Returns the channel partners that are associated with the given vendor. Integer (>0)

NOTE    By default, a GET call returns a maximum of 200 entries per page. You can change this by modifying the pageIndex and pageSize values. (To change the default maximum number of returned entries for all GET calls for Products, Entitlements, and Customers, modify the Max Records per Page (Web Services) value in the Sentinel LDK-EMS Administration Console. For details, see the Sentinel LDK-EMS Configuration Guide.)

Sample Response

HTTP Status Code: 200

Success

Response Header:

X-Total-Count: The total number of entries. You can use X-Total-Count to calculate the total number of pages by dividing X-Total-Count by pageSize (X-Total-Count÷pageSize=number of pages). For example, suppose your application returns an X-Total-Count of 17 and the pageSize is 15. 17÷15=1.333 or 2 pages in total because each page includes a maximum of 15 entries. Similarly, suppose your application returns an X-Total-Count of 1103 and the pageSize is 15. 1103÷15=73.533 or 74 pages in total.

Response Body

<listResponse type="partner" count="6">
   <instance partnerId="6" name="Priya Shetye" partnerRefId="aaaaaaa6-bbb7-ccc8-ddd9-eeeeeeeeeee0" refId1="106" type="ind" enabled="true" phone="+973-93850001" fax="" billingZip="11234" billingAddress="24 Hegde Drive" billingCity="Bangalore" billingCountry="India" billingState="" vendorId="1" defaultEmail="p.shetye025@testsite.com" defaultContactName="Priya Shetye"/>
   <instance partnerId="5" name="Parag Mahajan" partnerRefId="aaaaaaa5-bbb6-ccc7-ddd8-eeeeeeeeeee9" refId1="105" type="ind" enabled="true" phone="+973-93850123" fax="" billingZip="23432" billingAddress="112 Main St" billingCity="Pune" billingCountry="India" billingState="" vendorId="1" defaultEmail="pmahajan@miain.com" defaultContactName="Parag Mahajan"/>
   <instance partnerId="4" name="Robert Jones" partnerRefId="aaaaaaa4-bbb5-ccc6-ddd7-eeeeeeeeeee8" refId1="104" type="ind" enabled="true" phone="845-311-0321232" fax="" billingZip="10952" billingAddress="148 Highview La" billingCity="New Square" billingCountry="" billingState="NY" vendorId="1" defaultEmail="rjr12@zahav15.net" defaultContactName="Robert Jones"/>
   <instance partnerId="3" name="Peter Adams" partnerRefId="aaaaaaa3-bbb4-ccc5-ddd6-eeeeeeeeeee7" refId1="103" type="ind" enabled="true" phone="555-8872-0977" fax="" billingZip="62204" billingAddress="1104 Fifth Ave" billingCity="Athens" billingCountry="" billingState="GA" vendorId="1" defaultEmail="adamsp@eliashim.com" defaultContactName="Peter Adams"/>
   <instance partnerId="2" name="Sara Brown" partnerRefId="aaaaaaa2-bbb3-ccc4-ddd5-eeeeeeeeeee6" refId1="102" type="ind" enabled="true" phone="555-234-7783" fax="" billingZip="62204" billingAddress="654 Four Mile Dr" billingCity="Arlington" billingCountry="" billingState="VA" vendorId="1" defaultEmail="sara@fast-ag.com" defaultContactName="Sara Brown"/>
   <instance partnerId="1" name="John Smith" partnerRefId="aaaaaaa1-bbb2-ccc3-ddd4-eeeeeeeeeee5" refId1="101" type="ind" enabled="true" phone="555-8872-0973" fax="" billingZip="34897" billingAddress="1104 Fifth Ave" billingCity="Athens" billingCountry="" billingState="GA" vendorId="1" defaultEmail="smithj@eliashim.com" defaultContactName="John Smith"/>
</listResponse>

NOTE   The order of the search result is decided on the basis of partnerId which acts as a unique identifier for each channel partner in the database.

Failure

Response Body: 

<listResponse type="partner" count="0"/>