---
title: "Get Organization User Agents"
method: GET
path: "/api/v1/organizations/users/{userId}/agents"
---

# Get Organization User Agents

`GET /api/v1/organizations/users/{userId}/agents`

## Request

- Base URL: `https://api.skyfire.xyz`
- URL: `https://api.skyfire.xyz/api/v1/organizations/users/{userId}/agents`
- Auth: API key in header `skyfire-api-key`

As an Organization Admin, list an organization user's agentswith their enrolled cards.

## Path parameters

- `userId` string, uuid, required

## Query parameters

- `agentGroupId` string, uuid

## Response `200`

Ok

- object[]
  - `agentId` string, required: Unique identifier of the agent.
  - `displayName` string, required: The agent's display name. For a group instance, the group's name.
  - `agentType` 'BUYER' | 'SELLER', required: Whether the agent buys or sells.
  - `active` boolean, required: The agent's own active flag.
  - `status` 'active' | 'inactive' | 'group_inactive', required: Whether the agent can transact. `group_inactive` means the agent is active but its agent group is deactivated.
  - `agentGroupId` string, nullable, required: The agent group this agent is an instance of, or `null` for an ungrouped agent.
  - `cards` object[], required: Active card enrollments, oldest first. Empty for seller agents.
    - `id` string, required: Card identifier, used with the preferred-card endpoints.
    - `network` string, required: Card network, e.g. `visa` or `mastercard`.
    - `lastFour` string, required: Last four digits of the card.
    - `suspended` boolean, required: Whether the card is currently suspended.
  - `preferredCardId` string, nullable, required: The card used by default, or `null`.

## 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/organizations/users/:userId/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)