YM REST Services

<back to all web services

GroupTypes

Requires Authentication
Requires any of the roles:admin, oauthadmin, member, oauthmember
The following routes are available for this service:
GET/Ams/{ClientID}/GroupTypesReturn a list of all group types.
GET/Ams/{ClientID}/Member/{MemberID}/GroupTypesReturn a list of group types for a member.
GroupTypes Parameters:
NameParameterData TypeRequiredDescription
StatusqueryStatusNo

Allowable Values

  • None
  • Joined
  • Pending
  • NotJoined
  • JoinedOrPending
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
GroupTypesResponse Parameters:
NameParameterData TypeRequiredDescription
GroupTypeListformList<GroupType>No
GroupType Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
TypeNameformstringNo
SortIndexformdouble?No
GroupsformList<Group>No
Group Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
StatusformStatus?No
JoinOptionformJoinOption?No

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}/GroupTypes HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	GroupTypeList: 
	[
		{
			Id: 0,
			TypeName: String,
			SortIndex: 0,
			Groups: 
			[
				{
					Id: 0,
					Name: String,
					Status: None,
					JoinOption: CanJoin
				}
			]
		}
	],
	Status: None,
	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-03T02:32:49.8938928-04:00,
	Device: Desktop
}