# Group API Reference

OpenAPI source: https://api.are.na/v3/openapi.json

## GET /v3/groups/{id}/members

- Label: Get group members
- Docs: https://www.are.na/developers/explore/group/members
- Markdown: https://www.are.na/developers/explore/group/members.md
- Requires resource id: yes
- Response content type: application/json

Returns a paginated list of group members. The group owner is always
returned as the first entry on page 1 with `role: "owner"`, followed by
collaborators in newest-first order with `role: "member"`. The total
count includes the owner.

Group managers see all collaborators; other readers only see
collaborators with confirmed accounts. The owner is always shown.

Path parameters:
- id: string (required) — Resource ID or slug

Query parameters:
- page: number (optional) — Page number for pagination
- per: number (optional) — Number of items per page (max 100)

Response schema:
```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "description": "Array of group members (owner first on page 1)",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "nullable": false,
            "description": "Unique identifier for the user",
            "example": 12345
          },
          "type": {
            "type": "string",
            "nullable": false,
            "description": "User type",
            "enum": [
              "User"
            ],
            "example": "User"
          },
          "name": {
            "type": "string",
            "nullable": false,
            "description": "User's display name",
            "example": "John Doe"
          },
          "slug": {
            "type": "string",
            "nullable": false,
            "description": "URL-safe identifier (use this in API paths)",
            "example": "john-doe"
          },
          "avatar": {
            "type": "string",
            "nullable": true,
            "description": "URL to user's avatar image",
            "format": "uri",
            "example": "https://d2w9rnfcy7mm78.cloudfront.net/12345/avatar.jpg"
          },
          "initials": {
            "type": "string",
            "nullable": false,
            "description": "User's initials",
            "example": "JD"
          },
          "role": {
            "type": "string",
            "nullable": false,
            "description": "The user's role on the group. `owner` is the group's creator;\n`member` is anyone else with a group membership.\n",
            "enum": [
              "owner",
              "member"
            ],
            "example": "member"
          }
        },
        "required": [
          "id",
          "type",
          "name",
          "slug",
          "avatar",
          "initials",
          "role"
        ],
        "description": "Group member entry, including the group owner and any collaborators",
        "refName": "GroupMember"
      }
    },
    "meta": {
      "type": "object",
      "description": "Pagination metadata",
      "required": [
        "current_page",
        "per_page",
        "total_pages",
        "total_count",
        "has_more_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "nullable": false,
          "description": "Current page number",
          "example": 1
        },
        "next_page": {
          "type": "integer",
          "nullable": true,
          "description": "Next page number (null if last page)",
          "example": 2
        },
        "prev_page": {
          "type": "integer",
          "nullable": true,
          "description": "Previous page number (null if first page)"
        },
        "per_page": {
          "type": "integer",
          "nullable": false,
          "description": "Number of items per page",
          "example": 25
        },
        "total_pages": {
          "type": "integer",
          "nullable": false,
          "description": "Total number of pages available",
          "example": 5
        },
        "total_count": {
          "type": "integer",
          "nullable": false,
          "description": "Total number of items available",
          "example": 120
        },
        "has_more_pages": {
          "type": "boolean",
          "nullable": false,
          "description": "Whether there are more pages available",
          "example": true
        }
      },
      "refName": "PaginationMeta"
    }
  },
  "required": [
    "data",
    "data",
    "meta"
  ],
  "description": "Paginated list of group members with total count",
  "refName": "GroupMemberListResponse"
}
```