---
title: "Get Agent Group Agents"
method: GET
path: "/api/v1/agent-groups/{agentGroupId}/agents"
---

# Get Agent Group Agents

`GET /api/v1/agent-groups/{agentGroupId}/agents`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/agent-groups/{agentGroupId}/agents`
- Auth: API key in header `skyfire-api-key`

As an Organization Admin, list the members of one of your organization's agent groups, one entry per enrolled user.

## Path parameters

- `agentGroupId` string, uuid, required

## Query parameters

- `includeUnenrolled` boolean
- `pageSize` integer
- `pageCursor` string

## Response `200`

Ok

- object[]
  - `userId` string, required: The enrolled organization user.
  - `agentId` string, required: The user's instance of the group: a buyer agent. Use it with the agent, card, and wallet endpoints.
  - `displayName` string, required: The instance's display name, which is the group's name.
  - `agentActive` boolean, required: The instance's own active flag. `false` once the user is unenrolled.
  - `status` 'active' | 'inactive' | 'group_inactive', required: Whether the instance can transact. `group_inactive` means the instance is active but the group is deactivated.
  - `enrolled` boolean, required: `false` once the user has been unenrolled.
  - `enrolledAt` string, required: When the user was enrolled.
  - `unenrolledAt` string, nullable, required: When the user was unenrolled, or `null` while enrolled.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `22cbec9d7630`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/changes/api/v1/agent-groups/:agentGroupId/agents/get.md)

---

[API](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis.md) - [All operations](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/skyfire/apis/skyfire-agent-and-token-apis/revisions/22cbec9d7630?raw)