---
title: "Get User"
method: GET
path: "/v4/organizations/{organizationId}/users/{userId}"
tags: ["Users"]
---

# Get User

`GET /v4/organizations/{organizationId}/users/{userId}`

## Request

- Base URL: `https://cloudapi.cloud.couchbase.com`
- URL: `https://cloudapi.cloud.couchbase.com/v4/organizations/{organizationId}/users/{userId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/docs/v4/organizations/:organizationId/users/:userId/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches the details of the given user.

In order to access this endpoint, the provided API key must have at least one of the following roles:
- Organization Owner
- Organization Member
- Project Creator

The results are always limited by the role and scope of the caller's privileges.

When performing a GET request for a user with an organization owner role, the response will exclude project-level permissions for that user. This is because organization owners have access to all resources at the organization level, rendering project-level permissions unnecessary for them.

To learn more about the roles, see [Organization Roles](https://docs.couchbase.com/cloud/organizations/organization-user-roles.html) and [Project Roles](https://docs.couchbase.com/cloud/projects/project-roles.html).

## Response `200`

Successfully fetched the user based on the userId.

- GetUserResponse
  - `id` string, required: The UUID of the user created.
  - `name` string, required: The name of the user.
  - `email` string, required: Email of the user.
  - `status` 'verified' | 'not-verified' | 'pending-primary', required: Depicts user status whether they are verified or not. - verified: It reflects a verified state for an email address where the user has proven that they have access to the email account. - not-verified: It reflects an unverified or pending verification state. - pending-primary: It reflects an unverified primary email address
  - `inactive` boolean, required: Depicts whether the user has accepted the invite for the organization.
  - `organizationId` string, required: A GUID4 identifier of the tenant.
  - `organizationRoles` OrganizationRoles[], required
  - `lastLogin` string, date-time: Time(UTC) at which user last logged in.
  - `region` string: Region of the user.
  - `timeZone` string: Time zone of the user.
  - `enableNotifications` boolean: After enabling email notifications for your account, you will start receiving email notification alerts from all databases in projects you are a part of.
  - `expiresAt` string, date-time: Time at which user expires.
  - `resources` Resource[]
    - `type` 'project': Type of the resource.
    - `id` string, uuid, required: Id of the project.
    - `roles` ProjectRoles[], required
  - `audit` CouchbaseAuditData, required
    - `createdBy` string, required: The user who created the resource; this will be a UUID4 ID for standard users and will be a string such as "internal-support" for internal Couchbase support users.
    - `createdAt` string, date-time, required: The RFC3339 timestamp associated with when the resource was initially created.
    - `modifiedBy` string, required: The user who last modified the resource; this will be a UUID4 ID for standard users and will be a string such as "internal-support" for internal Couchbase support users.
    - `modifiedAt` string, date-time, required: The RFC3339 timestamp associated with when the resource was last modified.
    - `version` integer, required: The version of the document. This value is incremented each time the resource is modified.

## Other responses

- `403`: The client does not have the necessary permissions to access this resource.
- `404`: The requested resource was not found.
- `422`: Request validation error.
- `429`: Returned when the client exceeds the rate limit for the given APIKey.
- `500`: An unexpected error occurred in the server while processing this request.

## Changes

- **2026-10-19** `a5e88bcf71cb`: 3 warning
  - added the new `organizationBillingAdmin` enum value to the `organizationRoles/items/` response property for the response status `200`
  - added the new `organizationBillingViewer` enum value to the `organizationRoles/items/` response property for the response status `200`
  - added the new `organizationReadOnly` enum value to the `organizationRoles/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/changes/v4/organizations/:organizationId/users/:userId/get.md)

---

[API](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api.md) - [All operations](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/couchbase/apis/couchbase-capella-management-api/revisions/a5e88bcf71cb?raw)