---
title: "GET /v1/members"
method: GET
path: "/v1/members"
tags: ["Member"]
---

# GET /v1/members

`GET /v1/members`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `page` integer
- `pageSize` integer
- `keyword` string
- `status` integer
- `userUID` string
- `email` string
- `phone` string
- `uids` string[]

## Response `200`

OK

- GoddessApiV1ListMemberReply
  - `items` GoddessApiV1MemberItem[]
    - `uid` string
    - `email` string
    - `phone` string
    - `status` integer
    - `createdAt` string
    - `updatedAt` string
    - `userUID` string
    - `name` string
    - `nickname` string
    - `avatar` string
    - `remark` string
    - `role` integer
  - `total` string
  - `page` integer
  - `pageSize` integer

## Changes

- **2026-03-04** `45a5546b53fa`: 1 warning, 1 info
  - removed the optional property `items/items/namespaceUID` from the response with the `200` status
  - added the optional property `items/items/role` to the response with the `200` status
- **2026-03-02** `1426b00d9122`: 1 info
  - endpoint added
- **2026-02-27** `9f425f6d2358`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/changes/v1/members/get.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-goddess-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-goddess-api/revisions/d97780a0ed10?raw)