/memberfilters/{id} – Alida Help Center

Prerequisite

Create a member group

Resource URL

/v1/applications/{communityApiKeyName}/memberfilters/{id}

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.

Available methods

Method	Description
GET	Returns a list of member groups.

Available fields

Item Description

categories

The string value for the member variable category. Possible values are:

system
memberGroup
healthReporting

condition

The filter criteria for the member group.

Tip: You can view the filter criteria in the application by clicking Member Groups in the left hand menu, and clicking the group name.

constraints

The constraints collection specifies a set of behaviors that the system will implement for a given Member Variable. For the most part, these need not be adjusted from their defaults. For each supported constraint in the collection, a boolean value is recorded.

Property	Description
`deleted`	Not implemented
`hidden`	When set to `true`, the Member Variable will no longer be returned when sending a GET request to the `/membervariables` resource. However, it will remain accessible by specifying an id using the `/membervariables/{id}` resource.

createDate The date-timestamp UTC the member group was created.

createdBy The GUID of the user who created the member group.

description The text description of the member filter.

id The GUID for the member group.

lastUpdateDate The date-timestamp (UTC) for when the member group was last updated.

lastUpdatedBy The GUID of the user who last updated the member group.

links

URLs that link to the:

/membercount: Returns the number of members in the group.
/memberids: Returns the member IDs of the members in the group.
/members: Returns the system and profile variable values for the members in the group.

name

The string name of the member group as it appears in the application.
The GUID for a system filter.

sourceId This is an internal field.

Example Response


{
  "id": <GUID of member group>,
  "sourceId": "00000000-0000-0000-0000-000000000000",
  "name": <string name of member group>,
  "description": <string description of member group>,
  "categories": [
    <system|memberGroup|healthReporting>
  ],
  "constraints": {
    "hidden": false,
    "deleted": false
  },
  "condition": {
    "operation": <and|or>,
    "conditions": [
      {
        "operation": <in|notIn>,
        "memberVariableId": <GUID of member variable>,
        "memberVariableValueIds": [
          <GUID of member variable>
        ]
      },
      {
        "operation": "or",
        "conditions": [
          {
            "operation": <and|or>,
            "conditions": [
              {
                "operation": <in|notIn>,
                "memberVariableId": <GUID of member variable>,
                "memberVariableValueIds": [
                  <GUID of member variable>
                ]
              },
              {
                "operation": <in|notIn>,
                "memberVariableId": <GUID of member variable>,
                "memberVariableValueIds": [
                  <GUID of member variable>
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "createDate": <date-time UTC>,
  "lastUpdateDate": <date-time UTC>,
  "createdBy": <GUID of user>,
  "lastUpdatedBy": <GUID of user>,
  "links": [
    {
      "rel": "memberCount",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/membercount"
    },
    {
      "rel": "memberIds",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/memberids"
    },
    {
      "rel": "members",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/members"
    }
  ],
  "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/memberfilters/{memberfiltrerId}"

Example Response (Calculated Date)


{
  "id": <GUID of member group>,
  "sourceId": "00000000-0000-0000-0000-000000000000",
  "name": <string name of member group>,
  "description": <string description of member group>,
  "categories": [
    <memberGroup>
  ],
  "constraints": {
    "hidden": false,
    "deleted": false
  },
  "condition": {
    "operation": <and|or>,
    "conditions": [
      {
        "operation": <in|notIn>,
        "memberVariableId": <GUID of member variable>,
        "memberVariableValueIds": [
          <GUID of member variable>
        ]
      },
      {
        "operation": "or",
        "conditions": [
          {
            "operation": <and|or>,
            "conditions": [
              {
                 "operation": "and",
                 "conditions": [
                 {
                   "operation": "<equals|greaterThanOrEqual|lessThanOrEqual",
                   "memberVariableId": "d4ef8f65-ef2d-409e-82e3-b0150150dcd7",
                   "memberVariableValue": <Integer value>,
                   "precision": "miliseconds"
                 }
               ]
             }
            ]
          }
        ]
      }
    ]
  },
  "createDate": <date-time UTC>,
  "lastUpdateDate": <date-time UTC>,
  "createdBy": <GUID of user>,
  "lastUpdatedBy": <GUID of user>,
  "links": [
    {
      "rel": "memberCount",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/membercount"
    },
    {
      "rel": "memberIds",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/memberids"
    },
    {
      "rel": "members",
      "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/MemberFilters/{memberfiltrerId}/members"
    }
  ],
  "href": "https://api.{region}.alida.com/v1/applications/{communityApiKeyName}/memberfilters/{memberfiltrerId}"