YM REST Services

<back to all web services

PeopleGroups

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/PeopleGroupsReturns a person's group relationship data.There are three types of relationships that members may have with particular groups; 'Administrator', 'Member' and 'Representative'. Groups are listed within nodes respective of their relationship type.
PeopleGroups Parameters:
NameParameterData TypeRequiredDescription
IDqueryintNo
BaseDto Parameters:
NameParameterData TypeRequiredDescription
UsingRedisformboolNo
AppInitTimeformDateTimeNo
ServerIDformstringNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
PeopleGroupsResponse Parameters:
NameParameterData TypeRequiredDescription
RelationshipsformList<Relationship>No
Relationship Parameters:
NameParameterData TypeRequiredDescription
RelationshipTagformstringNo
GroupsformList<PeopleGroup>No
PeopleGroup Parameters:
NameParameterData TypeRequiredDescription
GroupIDformintNo
CodeformstringNo
NameformstringNo
TitleformstringNo
PrimaryformboolNo

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.

GET /Ams/{ClientID}/PeopleGroups HTTP/1.1 
Host: ws.yourmembership.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"Relationships":[{"RelationshipTag":"String","Groups":[{"GroupID":0,"Code":"String","Name":"String","Title":"String","Primary":false}]}],"ID":0,"UsingRedis":true,"AppInitTime":"2024-05-03T00:47:02.7459456-04:00","ServerID":"WS-4-7-585","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-03T03:33:20.4006582-04:00","Device":"Desktop"}