Get members who completed activities on a given day

Get a list of members who completed activities on a given day to award incentive program points in another system.

Depending on the awards program, some members may fall under different categories that qualify them for different incentives. For example, you may have one program for Loyal members and another program for New members.

After you get the list of IDs for members who completed the activity on a given day, you may also need to get the members' latest member variable values to ensure they are eligible for an award. For more information, see Member Data Service.

Note:

Use the appropriate regional endpoint to ensure that you comply with your organization's privacy policy, and applicable laws and regulations. For details about the available regional endpoints, and how to identify your organization's region, see Shared responsibility.

Example: GET all members who completed any survey on Oct 28, 2016

Request URL:

GET https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/memberevents?limit=1000&fields=memberId&eventType=SurveyCompleted&q=eventDate>="2016-10-28T00:00:00Z" and eventDate<"2016-10-29T00:00:00Z"

Response content:

{
   "meta": {
      "offset": 0,
      "limit": 1000,
      "count": 6
   },
   "items": [
      {
         "memberId": "e7957bef-f32f-4047-aeb5-a6ad00d5b441"
      },
      {
         "memberId": "79651831-abca-4d92-97d6-a6ad00d5b49e"
      },
      {
         "memberId": "b77ef703-86d1-45a1-9f65-a6ad00d5b49e"
      },
      {
         "memberId": "6b921721-14ba-4b59-a76f-a6ad00d5b49e"
      },
      {
         "memberId": "bce2459f-a6f0-4433-83fb-a6ad00d5b49e"
      },
      {
         "memberId": "f61824cd-3551-4e41-bd13-a6ad00d5b4ef"
      }
   ],
   ...
}

After you get the member IDs, get the latest member variable value for a member to ensure the member is eligible for an award.

Example: GET the latest member variable value for a member

Request URL:

GET https://api.{region}.alida.com/v1/applications/CommunityAPIKeyName/membervalues/asof/9999?memberId=e7957bef-f32f-4047-aeb5-a6ad00d5b441&memberVariableId=bc55aa95-2a7f-4d75-86b4-a3780118a164&
fields=memberId,memberVariableValue,effectiveDate

Response Content:

{
   "meta": {
      "offset": 0,
      "limit": 20,
      "count": 1
   },
   "items": [
      {
         "memberId": "e7957bef-f32f-4047-aeb5-a6ad00d5b441",
         "memberVariableValue": "Advertisement",
         "effectiveDate": "2016-06-21T06:10:08.2715344Z"
      }
   ],
   ...
}

Parent topic: Common scenario: Member Events