OpenAI API (unofficial showcase)
GET/organization/users/{user_id}

Retrieve an organization user

Retrieves a user from the organization by their identifier. Use this operation to view the user's organization role, account details, and associated user metadata.

1 parameter
user_idstringrequired
The ID of the user to retrieve.

4 status codes
200Returns the organization user object, including the user's ID, organization role, timestamps, and user details.
objectstringrequired
The object type, which is always `organization.user`
Allowed:organization.user
idstringrequired
The identifier, which can be referenced in API endpoints
namestringoptional
The name of the user
emailstringoptional
The email address of the user
rolestringoptional
`owner` or `reader`
added_atintegerrequired
The Unix timestamp (in seconds) of when the user was added.
is_defaultbooleanoptional
Whether this is the organization's default user.
createdintegeroptional
The Unix timestamp (in seconds) of when the user was created.
userobjectoptional
Nested user details.
is_service_accountbooleanoptional
Whether the user is a service account.
is_scale_tier_authorized_purchaserbooleanoptional
Whether the user is an authorized purchaser for Scale Tier.
is_scim_managedbooleanoptional
Whether the user is managed through SCIM.
api_key_last_used_atintegeroptional
The Unix timestamp (in seconds) of the user's last API key usage.
technical_levelstringoptional
The technical level metadata for the user.
developer_personastringoptional
The developer persona metadata for the user.
projectsobjectoptional
Projects associated with the user, if included.
403Returned when the caller does not have permission to perform this operation.
errorobjectrequired
Details about the permission error.
404Returned when the user is not found in the organization.
errorobjectrequired
429Returned when management requests exceed the rate limit.
errorobjectrequired

Error handling

The user_id path parameter must identify a user in the organization; a 404 is returned if the user is not found. A 403 is returned when the authenticated user does not have permission to retrieve the user. A 429 is returned when management requests exceed the rate limit.