YM REST Services

<back to all web services

MemberList

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
GET/Ams/{ClientID}/MemberListReturns a list of Members, based on GroupCodeRequired parameters are PageSize, PageNumber. FieldSelection is a string that accepts a combination of member's response fields seperated by comma.
MemberList Parameters:
NameParameterData TypeRequiredDescription
GroupCodequerystringNo
PageSizequeryintNo
PageNumberqueryintNo
FieldSelectionquerystringNo
BaseDto Parameters:
NameParameterData TypeRequiredDescription
UsingRedisformboolNo
AppInitTimeformDateTimeNo
ServerIDformstringNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
MemberListResponse Parameters:
NameParameterData TypeRequiredDescription
MembersformList<MemberResponse>No
TotalMemberFoundformintNo
MemberResponse Parameters:
NameParameterData TypeRequiredDescription
ProfileIDformintNo
IsMemberformboolNo
ImportIDformstringNo
Approvedformbool?No
SuspendedformboolNo
MasterIDformstringNo
ApprovalDateformDateTime?No
QueuedForDeleteformboolNo
QueuedForDeleteDateformDateTimeNo
MembershipEffectiveExpiresDateformDateTimeNo
EmailBouncedformbool?No
HasConsentedformboolNo
DateConsentedformDateTimeNo
ConsentIPAddressformstringNo
HasRevokedConsentformboolNo
DateConsentRevokedformDateTimeNo
MasterProfileIDformstringNoThis key replaces the “MasterID” key.
UserNameformstringNo
MembershipExpiresformboolNo
MembershipExpiresDateformDateTimeNo
SubordinateSeatsformintNo
ConstituentIDformstringNo
MemberTypeCodeformstringNo
RegisteredformDateTimeNo
MembershipformstringNo
LastRenewalDateformDateTimeNo
LastRenewalReminderSentformDateTimeNo
PrimaryGroupCodeformstringNo
LastUpdatedformDateTimeNo
GenderformstringNo
PrefixformstringNo
FirstNameformstringNo
MiddleNameformstringNo
LastNameformstringNo
SuffixformstringNo
NickNameformstringNo
MaidenNameformstringNo
SpouseNameformstringNo
MaritalStatusformstringNo
AnniversaryDateformDateTimeNo
BirthdayDateformDateTimeNo
HomeUrlformstringNo
HomeAddressLine1formstringNo
HomeAddressLine2formstringNo
HomeAddressCityformstringNo
HomeAddressLocationformstringNo
HomeAddressPostalCodeformstringNo
HomeAddressCountryformstringNo
HomePhoneCountryCodeformstringNo
HomePhoneAreaCodeformstringNo
HomePhoneNumberformstringNo
HomeFaxNumberformstringNo
HomeFaxCountryCodeformstringNo
HomeFaxAreaCodeformstringNo
EmailformstringNo
EmailAltformstringNo
HeadshotImageURIformstringNo
EmployerNameformstringNo
SelfEmployedformboolNo
WorkTitleformstringNo
WorkTypeformstringNo
WorkUrlformstringNo
WorkAddressLine1formstringNo
WorkAddressLine2formstringNo
WorkAddressCityformstringNo
WorkAddressLocationformstringNo
WorkAddressPostalCodeformstringNo
WorkAddressCountryformstringNo
WorkPhoneCountryCodeformstringNo
WorkPhoneNumberformstringNo
WorkPhoneAreaCodeformstringNo
WorkFaxNumberformstringNo
WorkFaxAreaCodeformstringNo
PersonalCommentsformstringNo
AdditionalEduformstringNo
SocialOrgsformstringNo
PreferredAddressLatitudeformdecimalNo
PreferredAddressLongitudeformdecimalNo
MemberCustomFieldResponsesformCustomFieldResponsesNo
CustomFieldResponse Parameters:
NameParameterData TypeRequiredDescription
FieldCodeformstringNo
FieldsformCustomFieldsNo
VisibilityformstringNo
VisibilityIntformintNo
ValuesformList<CustomFieldResponseValue>No
ValuesProxyformArrayListNo
MetaValueformCustomFieldResponseValueNo
ClientIDformintNo
CustomField Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
FieldTypeformCustomFieldTypeNo
GroupCodeformstringNo
GroupCodeFriendlyformstringNo
RequiredformboolNo
VisibleformintNo
MemberCanOverrideformboolNo
EditableformintNo
SearchableformboolNo
OrdinalformintNo
MaxLengthformintNo
IsMultiSelectformboolNo
IsFIBformboolNo
IsFileUploadformboolNo
LabelformstringNo
CodeformstringNo
ExportLabelformstringNo
SearchLabelformstringNo
SearchInfoformstringNo
DescriptionformstringNo
ValidationExpressionformstringNo
MemberTypesformList<CustomFieldMemberType>No
DonationFundsformList<CustomFieldDonationFund>No
MemberTypesProxyformArrayListNo
ValuesformList<CustomFieldValue>No
ValuesProxyformArrayListNo
HelpTopicformCustomHelpNo
FieldDataTypeformFieldTypesNo
CustomFieldMemberType Parameters:
NameParameterData TypeRequiredDescription
MemberTypeIDformstringNo
CustomFieldDonationFund Parameters:
NameParameterData TypeRequiredDescription
DonationFundIDformstringNo
CustomFieldValue Parameters:
NameParameterData TypeRequiredDescription
OrdinalformintNo
TextformstringNo
ValueformstringNo
CustomHelp Parameters:
NameParameterData TypeRequiredDescription
IDformintNo
ClientIDformintNo
LabelformstringNo
ContentformstringNo
WidthformintNo
HeightformintNo
CustomFieldResponseValue Parameters:
NameParameterData TypeRequiredDescription
ValueformstringNo
TextformstringNo

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

{"Members":[{"ProfileID":0,"IsMember":false,"ImportID":"String","Approved":false,"Suspended":false,"MasterID":"String","ApprovalDate":"0001-01-01T00:00:00.0000000","QueuedForDelete":false,"QueuedForDeleteDate":"0001-01-01T00:00:00.0000000","MembershipEffectiveExpiresDate":"0001-01-01T00:00:00.0000000","EmailBounced":false,"HasConsented":false,"DateConsented":"0001-01-01T00:00:00.0000000","ConsentIPAddress":"String","HasRevokedConsent":false,"DateConsentRevoked":"0001-01-01T00:00:00.0000000","MasterProfileID":"String","UserName":"String","MembershipExpires":false,"MembershipExpiresDate":"0001-01-01T00:00:00.0000000","SubordinateSeats":0,"ConstituentID":"String","MemberTypeCode":"String","Registered":"0001-01-01T00:00:00.0000000","Membership":"String","LastRenewalDate":"0001-01-01T00:00:00.0000000","LastRenewalReminderSent":"0001-01-01T00:00:00.0000000","PrimaryGroupCode":"String","LastUpdated":"0001-01-01T00:00:00.0000000","Gender":"String","Prefix":"String","FirstName":"String","MiddleName":"String","LastName":"String","Suffix":"String","NickName":"String","MaidenName":"String","SpouseName":"String","MaritalStatus":"String","AnniversaryDate":"0001-01-01T00:00:00.0000000","BirthdayDate":"0001-01-01T00:00:00.0000000","HomeUrl":"String","HomeAddressLine1":"String","HomeAddressLine2":"String","HomeAddressCity":"String","HomeAddressLocation":"String","HomeAddressPostalCode":"String","HomeAddressCountry":"String","HomePhoneCountryCode":"String","HomePhoneAreaCode":"String","HomePhoneNumber":"String","HomeFaxNumber":"String","HomeFaxCountryCode":"String","HomeFaxAreaCode":"String","Email":"String","EmailAlt":"String","HeadshotImageURI":"String","EmployerName":"String","SelfEmployed":false,"WorkTitle":"String","WorkType":"String","WorkUrl":"String","WorkAddressLine1":"String","WorkAddressLine2":"String","WorkAddressCity":"String","WorkAddressLocation":"String","WorkAddressPostalCode":"String","WorkAddressCountry":"String","WorkPhoneCountryCode":"String","WorkPhoneNumber":"String","WorkPhoneAreaCode":"String","WorkFaxNumber":"String","WorkFaxAreaCode":"String","PersonalComments":"String","AdditionalEdu":"String","SocialOrgs":"String","PreferredAddressLatitude":0,"PreferredAddressLongitude":0,"MemberCustomFieldResponses":[{"FieldCode":"String","Fields":[{"ClientID":0,"FieldType":"Textbox","GroupCode":"String","GroupCodeFriendly":"String","Required":false,"Visible":0,"MemberCanOverride":false,"Editable":0,"Searchable":false,"Ordinal":0,"MaxLength":0,"IsMultiSelect":false,"IsFIB":true,"IsFileUpload":false,"Label":"String","Code":"String","ExportLabel":"String","SearchLabel":"String","SearchInfo":"String","Description":"String","ValidationExpression":"String","MemberTypes":[{"MemberTypeID":"String"}],"DonationFunds":[{"DonationFundID":"String"}],"MemberTypesProxy":[{"MemberTypeID":"String"}],"Values":[{"Ordinal":0,"Text":"String","Value":"String"}],"ValuesProxy":[{"Ordinal":0,"Text":"String","Value":"String"}],"HelpTopic":{"ID":0,"ClientID":0,"Label":"String","Content":"String","Width":0,"Height":0},"FieldDataType":"String"}],"Visibility":"String","VisibilityInt":2,"Values":[{"Value":"String","Text":"String"}],"ValuesProxy":[{"Value":"String","Text":"String"}],"MetaValue":{"Value":"String","Text":"String"},"ClientID":0}]}],"TotalMemberFound":0,"UsingRedis":true,"AppInitTime":"2024-05-03T03:57:42.3953655-04:00","ServerID":"WS-5-59-079","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-03T06:06:18.2531183-04:00","Device":"Desktop"}