> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Group Members > Returns all users with access to a group. By default, the response merges **organization members** (implicit access to every group in the org) and users with explicit **group-member rows**, tagging each entry with an `access_type` field (`organization` or `group`). If a user has both an org membership and a `group_members` row, the merged view returns them once as `access_type: "organization"` (org precedence). Use the `access_type` query parameter to filter: `?access_type=group` returns the raw `group_members` rows (including users who also have org access), and `?access_type=organization` returns only the org's implicit members. Requires a global API key. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/groups/{group_id}/members openapi: 3.1.0 info: title: AthenaHQ API description: >- AthenaHQ API provides programmatic access to manage your websites and prompts for AI-powered content optimization. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Production server security: - apiKey: [] tags: - name: Basics description: Core API operations for managing websites and prompts - name: Metrics description: Metrics and analytics endpoints for tracking AI visibility - name: Billing description: Billing and credits endpoints for managing usage - name: Team Management description: Endpoints for managing team members and invitations - name: Groups description: Endpoints for managing groups of websites - name: Content description: >- Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL prompt breakdowns. - name: Pitch Workspace description: >- Endpoints for accessing pitch workspace reports — org-scoped pitch runs with competitors, prompts, attributes, and aggregate metrics. - name: Knowledge Base description: >- Endpoints for reading the brand Knowledge Base — approved brand facts and the pillars that organize them. paths: /api/v1/groups/{group_id}/members: parameters: - name: group_id in: path required: true schema: type: string format: uuid description: The unique identifier of the group - name: access_type in: query required: false schema: type: string enum: - organization - group description: >- Optional filter. Pass `group` to get only users explicitly added to this group's `group_members` table — a user who also has org access is still returned (raw rows, no dedup). Pass `organization` to get only the parent org's members. Omit the parameter to get the merged view with org-member precedence. get: tags: - Team Management summary: List Group Members description: >- Returns all users with access to a group. By default, the response merges **organization members** (implicit access to every group in the org) and users with explicit **group-member rows**, tagging each entry with an `access_type` field (`organization` or `group`). If a user has both an org membership and a `group_members` row, the merged view returns them once as `access_type: "organization"` (org precedence). Use the `access_type` query parameter to filter: `?access_type=group` returns the raw `group_members` rows (including users who also have org access), and `?access_type=organization` returns only the org's implicit members. Requires a global API key. operationId: listGroupMembers responses: '200': description: Successful response with the list of members content: application/json: schema: type: object properties: members: type: array items: $ref: '#/components/schemas/GroupMemberListItem' required: - members '400': description: Bad request - Invalid group ID format or invalid access_type value content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_group_id: summary: Invalid group ID format value: error: Invalid group ID format invalid_access_type: summary: Invalid access_type value value: error: access_type must be 'organization' or 'group' '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Forbidden - Global API key required content: application/json: schema: $ref: '#/components/schemas/Error' example: error: 'Forbidden: global API key required' '404': description: >- Not found - Group does not exist or does not belong to your organization content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Group not found '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' security: - apiKey: [] components: schemas: GroupMemberListItem: type: object description: >- A user with access to a group. Includes both organization members (implicit access to every group in the org) and users with explicit group membership. required: - user_id - email - role - access_type - created_at properties: user_id: type: string format: uuid description: Unique identifier of the user email: type: string format: email description: The user's email address first_name: type: string nullable: true description: The user's first name, if set last_name: type: string nullable: true description: The user's last name, if set role: type: string description: >- The user's role. For `access_type: "organization"`, this is the organization role. For `access_type: "group"`, this is the per-group role. Each role is its slug — the role's normalized name (lowercase, no spaces): `admin`, `viewer`, `editor`, `billing`, or a custom role's id (e.g. `contentmanager`). `admin` and `viewer` are unchanged from prior versions. access_type: type: string enum: - organization - group description: >- How the user has access to the group. `organization` = implicit access via org membership. `group` = explicit group_members row. created_at: type: string format: date-time description: When the membership row was created (UTC) Error: type: object description: Error response object required: - error properties: error: type: string description: Error message describing what went wrong example: Unauthorized securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- API key for authentication. You can create one [here](https://app.athenahq.ai/organization?tab=api). ````