YM REST Services

TopContributors

**Requires Authentication**
Requires any of the roles:	admin, oauthadmin, member, oauthmember

The following routes are available for this service:
GET	/Ams/{ClientID}/TopContributors	Return a list of TopContributors for the Admin.
GET	/Ams/{ClientID}/Member/{MemberID}/TopContributors	Return a list of TopContributors for the Member.

**TopContributors** Parameters:
Name	Parameter	Data Type	Required
DateBegin	query	DateTime	No
DateEnd	query	DateTime	No
PageNumber	query	int	No
PageSize	query	int	No

**MemberBaseSharedDto** Parameters:
Name	Parameter	Data Type	Required	Description
MemberID	form	int	No

**BaseSharedDto** Parameters:
Name	Parameter	Data Type	Required
ClientID	form	int	No
ResponseStatus	form	ResponseStatus	No
BypassCache	form	bool	No
DateCached	form	DateTime	No
Device	form	Device	No

**TopContributorsResponse** Parameters:
Name	Parameter	Data Type	Required	Description
CurrentContributor	form	TopContributor	No
ContributorList	form	List<TopContributor>	No

**TopContributor** Parameters:
Name	Parameter	Data Type	Required
RankNumber	form	int	No
RankPercentage	form	int	No
RankBaseline	form	int	No
Score	form	int	No
PostCount	form	int	No
CommentCount	form	int	No
LikeCount	form	int	No
LevelId	form	int	No
LevelName	form	string	No
DisplayOptions	form	DisplayOptions	No

**Connection** Parameters:
Name	Parameter	Data Type	Required
ConnectionStatus	form	ConnectionStatus?	No
ConnectionId	form	int	No
FirstName	form	string	No
LastName	form	string	No
ConnectionName	form	string	No
Organization	form	string	No
HeadShotImage	form	string	No
WorkTitle	form	string	No
MemberType	form	string	No
City	form	string	No
State	form	string	No
Location	form	string	No
Country	form	string	No
Shared	form	bool	No
Email	form	string	No
PhoneLabel	form	string	No
PhoneAreaCode	form	string	No
PhoneNumber	form	string	No
FaxLabel	form	string	No
FaxAreaCode	form	string	No
FaxNumber	form	string	No
CanShow	form	ShowPreferences	No
intCategoryID	form	int	No
IsAmbassador	form	bool	No

**ShowPreferences** Parameters:
Name	Parameter	Data Type	Required
City	form	bool	No
Location	form	bool	No
Country	form	bool	No
Phone	form	bool	No
Fax	form	bool	No
Email	form	bool	No
EmployerName	form	bool	No
EmployerTitle	form	bool	No

**DisplayOptions** Parameters:
Name	Parameter	Data Type	Required
ShowOnlineNow	form	bool	No
ShowOrganization	form	bool	No
ShowMessageButton	form	bool	No
ShowConnectButton	form	bool	No
ShowIMUsername	form	bool	No
ShowNickName	form	bool	No
ShowMaidenName	form	bool	No
ShowBirthdayDate	form	bool	No
ShowMarriageStatus	form	bool	No
ShowWeddingDate	form	bool	No
ShowSpouse	form	bool	No
ShowPrimaryEmail	form	bool	No
ShowHomeAddress	form	bool	No
ShowHomeAddress2	form	bool	No
ShowHomeCity	form	bool	No
ShowHomeZip	form	bool	No
ShowHomePhone	form	bool	No
ShowHomeFax	form	bool	No
ShowWorkAddress	form	bool	No
ShowWorkAddress2	form	bool	No
ShowWorkCity	form	bool	No
ShowWorkZip	form	bool	No
ShowWorkPhone	form	bool	No
ShowWorkFax	form	bool	No
ShowEmployerName	form	bool	No
ShowEmployerTitle	form	bool	No
ShowEmployerLocation	form	bool	No
ShowEmployerOwnsBusiness	form	bool	No
ShowHomeCountry	form	bool	No
ShowHomeLocation	form	bool	No
ShowWorkCountry	form	bool	No
ShowResume	form	bool	No
ProfilePhoto	form	bool	No
ShowGameBadge	form	bool	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}/TopContributors HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	CurrentContributor: 
	{
		RankNumber: 0,
		RankPercentage: 0,
		RankBaseline: 0,
		Score: 0,
		PostCount: 0,
		CommentCount: 0,
		LikeCount: 0,
		LevelId: 0,
		LevelName: String,
		DisplayOptions: 
		{
			ShowOnlineNow: False,
			ShowOrganization: False,
			ShowMessageButton: False,
			ShowConnectButton: False,
			ShowIMUsername: False,
			ShowNickName: False,
			ShowMaidenName: False,
			ShowBirthdayDate: False,
			ShowMarriageStatus: False,
			ShowWeddingDate: False,
			ShowSpouse: False,
			ShowPrimaryEmail: False,
			ShowHomeAddress: False,
			ShowHomeAddress2: False,
			ShowHomeCity: False,
			ShowHomeZip: False,
			ShowHomePhone: False,
			ShowHomeFax: False,
			ShowWorkAddress: False,
			ShowWorkAddress2: False,
			ShowWorkCity: False,
			ShowWorkZip: False,
			ShowWorkPhone: False,
			ShowWorkFax: False,
			ShowEmployerName: False,
			ShowEmployerTitle: False,
			ShowEmployerLocation: False,
			ShowEmployerOwnsBusiness: False,
			ShowHomeCountry: False,
			ShowHomeLocation: False,
			ShowWorkCountry: False,
			ShowResume: False,
			ProfilePhoto: False,
			ShowGameBadge: False
		},
		ConnectionStatus: None,
		ConnectionId: 0,
		FirstName: String,
		LastName: String,
		ConnectionName: String,
		Organization: String,
		HeadShotImage: String,
		WorkTitle: String,
		MemberType: String,
		City: String,
		State: String,
		Location: String,
		Country: String,
		Shared: False,
		Email: String,
		PhoneLabel: String,
		PhoneAreaCode: String,
		PhoneNumber: String,
		FaxLabel: String,
		FaxAreaCode: String,
		FaxNumber: String,
		CanShow: 
		{
			City: False,
			Location: False,
			Country: False,
			Phone: False,
			Fax: False,
			Email: False,
			EmployerName: False,
			EmployerTitle: False
		},
		intCategoryID: 0,
		IsAmbassador: False
	},
	ContributorList: 
	[
		{
			RankNumber: 0,
			RankPercentage: 0,
			RankBaseline: 0,
			Score: 0,
			PostCount: 0,
			CommentCount: 0,
			LikeCount: 0,
			LevelId: 0,
			LevelName: String,
			DisplayOptions: 
			{
				ShowOnlineNow: False,
				ShowOrganization: False,
				ShowMessageButton: False,
				ShowConnectButton: False,
				ShowIMUsername: False,
				ShowNickName: False,
				ShowMaidenName: False,
				ShowBirthdayDate: False,
				ShowMarriageStatus: False,
				ShowWeddingDate: False,
				ShowSpouse: False,
				ShowPrimaryEmail: False,
				ShowHomeAddress: False,
				ShowHomeAddress2: False,
				ShowHomeCity: False,
				ShowHomeZip: False,
				ShowHomePhone: False,
				ShowHomeFax: False,
				ShowWorkAddress: False,
				ShowWorkAddress2: False,
				ShowWorkCity: False,
				ShowWorkZip: False,
				ShowWorkPhone: False,
				ShowWorkFax: False,
				ShowEmployerName: False,
				ShowEmployerTitle: False,
				ShowEmployerLocation: False,
				ShowEmployerOwnsBusiness: False,
				ShowHomeCountry: False,
				ShowHomeLocation: False,
				ShowWorkCountry: False,
				ShowResume: False,
				ProfilePhoto: False,
				ShowGameBadge: False
			},
			ConnectionStatus: None,
			ConnectionId: 0,
			FirstName: String,
			LastName: String,
			ConnectionName: String,
			Organization: String,
			HeadShotImage: String,
			WorkTitle: String,
			MemberType: String,
			City: String,
			State: String,
			Location: String,
			Country: String,
			Shared: False,
			Email: String,
			PhoneLabel: String,
			PhoneAreaCode: String,
			PhoneNumber: String,
			FaxLabel: String,
			FaxAreaCode: String,
			FaxNumber: String,
			CanShow: 
			{
				City: False,
				Location: False,
				Country: False,
				Phone: False,
				Fax: False,
				Email: False,
				EmployerName: False,
				EmployerTitle: False
			},
			intCategoryID: 0,
			IsAmbassador: False
		}
	],
	DateBegin: 0001-01-01,
	DateEnd: 0001-01-01,
	PageNumber: 0,
	PageSize: 0,
	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: 2025-12-21T04:45:46.2661425-05:00,
	Device: Desktop
}