GET /api/:space/member-messages/memberRef/:memberRefId

Description:

Returns a list of messages for a specified member.

This assumes that messages have first been generated otherwise no data will be returned and the value of the "totalRecordsFound" variable in metadata will be 0.

GET responses can be filtered out based on the member-messages parameters to narrow down the results.

Resource URL:

https://<apphost>.competitionlabs.com/api/<your-space>/member-messages/memberRef/<memberRefId>

Request header

KeyValueRequired
X-API-KEY

Yes
Content-Type
application/jsonYes

Request URL parameter

Parameter
Type
Required
Description
space
StringYesThis is the space name which is linked to the account
memberRefId
StringYesMember reference identifiers retrieved from GET Members resource.


Example:

Request
curl
--header "X-API-KEY: <your-api-key>"
--request GET https://app.competitionlabs.com/api/<your-space>/member-messages/memberRef/tester
Response
{
	"meta": {
		"time": "2021-06-01T08:51:15.388Z",
		"totalRecordsFound": 1,
		"skip": 0,
		"limit": 20
	},
	"data": [{
		"jsonClass": "MemberMessage",
		"accountId": "TOQR32kB2TUmRj7Y-123",
		"memberId": "8W9033AByU-7qJmnbO4C",
		"eventRefType": "AchievementType",
		"eventReferenceId": "13U21HABb04K7-5xQMFl",
		"messageType": "Achievement",
		"subject": "test",
		"body": "",
		"status": "New",
		"created": "2020-03-15T18:48:39.118+0000",
		"metadata": [{
			"jsonClass": "Metadata",
			"key": "icon",
			"value": "6OwBqXABnvGGsQQTfHFp"
		}],
		"id": "GB-G33ABWweu1ZXez1LO"
	}]
}