YM REST Services

<back to all web services

DirectorySearch

Requires Authentication
Requires any of the roles:member, oauthmember, admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/Member/{MemberID}/DirectorySearchReturn a list of members based on term.
DirectorySearch Parameters:
NameParameterData TypeRequiredDescription
TermquerystringNo
PageSizequeryintNo
StartIndexqueryintNo
IncludeNonMembersqueryboolNo
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
DirectorySearchResponse Parameters:
NameParameterData TypeRequiredDescription
ResultCountformintNo
DirectorySearchProfileListformList<DirectorySearchProfile>No
DirectorySearchProfile Parameters:
NameParameterData TypeRequiredDescription
CanHaveConnectionsformboolNo
CanUseMessagingformboolNo
MemberIDformintNo
PrimaryGroupNameformstringNo
IsMemberformboolNo
IsNonMemberformboolNo
NameformstringNo
CityformstringNo
LocationformstringNo
AddressLine1formstringNo
AddressLine2formstringNo
PhoneformstringNo
HeadshotImagePathformstringNo
NonMemberLostformboolNo
NonMemberDeceasedformboolNo
NonMemberCommentsformstringNo
JobTitleformstringNo

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.

GET /Ams/{ClientID}/Member/{MemberID}/DirectorySearch HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ResultCount: 0,
	DirectorySearchProfileList: 
	[
		{
			CanHaveConnections: False,
			CanUseMessaging: False,
			MemberID: 0,
			PrimaryGroupName: String,
			IsMember: False,
			IsNonMember: False,
			Name: String,
			City: String,
			Location: String,
			AddressLine1: String,
			AddressLine2: String,
			Phone: String,
			HeadshotImagePath: String,
			NonMemberLost: False,
			NonMemberDeceased: False,
			NonMemberComments: String,
			JobTitle: String
		}
	],
	Term: String,
	PageSize: 0,
	StartIndex: 0,
	IncludeNonMembers: False,
	MemberID: 0,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T10:42:25.7905643-04:00,
	Device: Desktop
}