**Version: 202601**

# Get member list

**POST** `/openapi/2026-01/loyalty/members`

Query members by member ID or email, up to 200 per request

## Request

**application/json**

**Body | Example**

**Body (required)**

- `search_type` string (required)

  Member locator type: member\_id or email
- `search_values` string[] (required)

  Locator values to query. Up to 200 per request

```json
{
  "search_type": "string",
  "search_values": [
    "string"
  ]
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `members` object[]

    Matched members

    *   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
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "members": [
      {
        "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"
      }
    ]
  }
}
```