HostedSuite

<back to all web services

ListClientsRequest

Retrieve list of client information

The following routes are available for this service:
POST/api/clients
ListClientsRequest Parameters:
NameParameterData TypeRequiredDescription
ClientIdbodystringNoID of the client you want to filter by. When using this only a single result will be returned.
NamebodystringNoName of the client you want to filter by.
CenterIdbodystringNoFilter by center
ThirdPartyAccountIdbodystringNoFilter by third party account ID
ScreenPopbodystringNoFilter by screen pop
CategoryIdsbodyList<string>NoList of category IDs that the client must have
CustomFieldsFilterbodyDictionary<string, string>NoFilter by custom fields
RequestBase<TResponse> Parameters:
NameParameterData TypeRequiredDescription
CustomerNameformstringYesThe HostedSuite Customer Name
UserNameformstringYesThe HostedSuite User Name. Data visibility and security is based on this user's permissions.
PasswordformstringYesThe HostedSuite User's Password

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/clients HTTP/1.1 
Host: evo.hostedsuite.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"ClientId":"String","Name":"String","CenterId":"String","ThirdPartyAccountId":"String","ScreenPop":"String","CategoryIds":["String"],"CustomFieldsFilter":{"String":"String"},"CustomerName":"String","UserName":"String","Password":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

[{"Id":"String","DateLastModified":"String","Name":"String","CenterId":"String","CenterName":"String","ScreenPops":["String"],"Greeting":"String","CallInstructions":"String","PopupInformation":"String","Information":"String","FaxNumber":"String","CustomFields":[{"Name":"String","Value":"String"}],"Address":{"Street1":"String","Street2":"String","City":"String","State":"String","PostalCode":"String","Country":"String"},"ThirdPartyAccountId":"String","CallAllowanceType":"NotBillable","CallAllowanceAmount":0,"Links":[{"Id":"String","Name":"String","Url":"String"}],"IndustryId":"String","IndustryName":"String","Location":"String"}]