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 .jsv suffix or ?format=jsv

HTTP + JSV

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: text/jsv
Content-Type: text/jsv
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: text/jsv
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
	}
]