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

# Get Organization User by ID

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

## Request

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

As an Organization Admin, fetch a single user in your organization by their user ID.

## Path parameters

- `userId` string, uuid, required

## Response `200`

Ok

- OrganizationUser
  - `id` string, required: Unique identifier of the organization user.
  - `organizationId` string, required: Unique identifier of the organization the user belongs to. Always your own organization.
  - `email` string, required: Email address of the user.
  - `isAdmin` boolean, required: Whether the user has Organization Admin privileges.
  - `orgMemberRole` 'ADMIN' | 'MEMBER' | 'REPRESENTATIVE', required: Role of the user within the organization.
  - `isActive` boolean, required: Whether the user is active. Inactive users cannot authenticate, and neither can their agents.
  - `agents` object[]: Agents owned by the user. Empty if the user owns none.
    - `agentId` string, required: Unique identifier of the agent.
    - `agentType` 'BUYER' | 'SELLER', required: Whether the agent is a buyer or a seller.
    - `accounts` object[]: Accounts belonging to the agent.
      - `accountId` string, required: Unique identifier of the account.
      - `network` string, required: Network the account is held on. e.g. `"base"`.
      - `active` boolean, required: Whether the account is active.
      - `suspended` boolean, required: Whether the account is suspended.
      - `createdAt` string, required: When the account was created. e.g. `"2026-08-14T09:12:33.000Z"`.
  - `createdAt` string, required: When the user was created. e.g. `"2026-08-14T09:12:33.000Z"`.

## Other responses

- `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/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)