**Version: 202607**

# Get member group detail

**GET** `/openapi/2026-07/loyalty/member-groups/:member_group_id`

Return the detail of a specific member segment

## Request

**Path Parameters**

- `member_group_id` string (required)

  Member group ID from path

**Query Parameters**

- `cursor` string

  Members pagination cursor
- `limit` int32

  Members page size

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  Get member group detail response

  - `member_group_id` string
  - `name` string
  - `is_real_time` boolean
  - `member_count` int64
  - `created_at` string
  - `updated_at` string
  - `member_condition` object

    Member condition expression (recursive tree)

    - `key` string
    - `operator` string
    - `value` GoogleProtobufValue

      Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.
    - `extra` object

      Member condition extra config (time window, categories, products, regions)

      - `time_range` string

        Time range window: all / 7d / 30d
      - `categories` object[]

        Categories filter, 2-level nested array (\[\["a","a-1"\],\["b"\]\])

        *   Array \[

        - `values` GoogleProtobufValue[]

          Repeated field of dynamically typed values.
        *   \]
      - `product_ids` string[]

        Product id list
      - `country_and_province` object

        Country+province map: key=country code, value=province codes (\["ALL"\]=whole country)

        - `property name*` ListValue

          `ListValue` is a wrapper around a repeated field of values.

          The JSON representation for `ListValue` is JSON array.

          - `values` GoogleProtobufValue[]

            Repeated field of dynamically typed values.
    - `relation` string
    - `children` undefined[]
  - `members` object

    Paginated members block inside member group detail

    - `items` object[]

      *   Array \[

      - `member_id` string

        Member ID
      - `email` string

        Member email
      - `phone` string

        Member phone
      - `first_name` string

        Member first name
      - `last_name` string

        Member last name
      - `current_tier_name` string

        Current tier name
      - `created_at` string

        Member created at, ISO-8601
      - `transactions_amount` string

        Accumulated transactions amount as a decimal string
      - `birthday` string

        Member birthday; empty string when not set
      - `status` string

        Member status: active / inactive / ...
      - `tags` string[]

        Member tags
      - `activated_at` string

        Loyalty activation time, ISO-8601; empty when not activated
      - `first_order_at` string

        First order time, ISO-8601; empty when none
      *   \]
    - `next_cursor` string
    - `has_more` boolean
    - `limit` int32

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "member_group_id": "string",
    "name": "string",
    "is_real_time": true,
    "member_count": 0,
    "created_at": "string",
    "updated_at": "string",
    "member_condition": {
      "key": "string",
      "operator": "string",
      "extra": {
        "time_range": "string",
        "categories": [
          {
            "values": [
              null
            ]
          }
        ],
        "product_ids": [
          "string"
        ],
        "country_and_province": {}
      },
      "relation": "string",
      "children": [
        null
      ]
    },
    "members": {
      "items": [
        {
          "member_id": "string",
          "email": "string",
          "phone": "string",
          "first_name": "string",
          "last_name": "string",
          "current_tier_name": "string",
          "created_at": "string",
          "transactions_amount": "string",
          "birthday": "string",
          "status": "string",
          "tags": [
            "string"
          ],
          "activated_at": "string",
          "first_order_at": "string"
        }
      ],
      "next_cursor": "string",
      "has_more": true,
      "limit": 0
    }
  }
}
```