YM REST Services

<back to all web services

Certifications

Requires Authentication
Requires any of the roles:admin, oauthadmin, member, oauthmember
The following routes are available for this service:
GET/Ams/{ClientID}/CertificationsReturn a list of all certification records for the community or a list of Certifications for the specified user.
GET/Ams/{ClientID}/Member/{MemberID}/CertificationsReturn a list of Certifications for the specified user.
Certifications Parameters:
NameParameterData TypeRequiredDescription
PersonIDqueryintNo
IsActivequerybool?No
IncludeInactivequerybool?No
PageSizequeryint?No
PageNumberqueryint?No
MemberBaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
MemberIDformintNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
CertificationsResponse Parameters:
NameParameterData TypeRequiredDescription
CertificationListformList<Certification>No
TotalCountformint?No
Certification Parameters:
NameParameterData TypeRequiredDescription
CertificationIDformstringNo
IDformstringNo
NameformstringNo
VisibleOnProfileformbool?No
IsActiveformboolNo
CEUsEarnedformint?No
CEUsRequiredformintNo
CEUsExpireDateformDateTime?No
CEUsExpiringformint?No
CodeformstringNo
CreditTypeListformList<CreditType>No
PrerequisiteListformList<Prerequisite>No
CreditType Parameters:
NameParameterData TypeRequiredDescription
ModeformintNo
IDformintNo
NameformstringNo
CodeformstringNo
CEUsRequiredformint?No
MaxCreditsformdouble?No
Prerequisite Parameters:
NameParameterData TypeRequiredDescription
CertificationIDformstringNo
IDformstringNo
NameformstringNo
CodeformstringNo

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

{
	CertificationList: 
	[
		{
			CertificationID: String,
			ID: String,
			Name: String,
			VisibleOnProfile: False,
			IsActive: False,
			CEUsEarned: 0,
			CEUsRequired: 0,
			CEUsExpireDate: 0001-01-01,
			CEUsExpiring: 0,
			Code: String,
			CreditTypeList: 
			[
				{
					Mode: 0,
					ID: 0,
					Name: String,
					Code: String,
					CEUsRequired: 0,
					MaxCredits: 0
				}
			],
			PrerequisiteList: 
			[
				{
					CertificationID: String,
					ID: String,
					Name: String,
					Code: String
				}
			]
		}
	],
	TotalCount: 0,
	PersonID: 0,
	IsActive: False,
	IncludeInactive: False,
	PageSize: 0,
	PageNumber: 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: 2024-05-03T05:05:56.6094561-04:00,
	Device: Desktop
}