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

HTTP + CSV

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/csv
HTTP/1.1 200 OK
Content-Type: text/csv
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-03T07:57:43.7942789-04:00","Device":"Desktop"}