Sample - OpenAI API
GET/organization/users/{user_id}

Retrieve an organization user

Retrieves a user from the organization by identifier. Use user_id to identify the user whose organization membership, role, metadata, and account details you want to inspect. The response includes timestamps and flags for default, service-account, and SCIM-managed users.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter
user_idstringrequired
The identifier of the organization user to retrieve.

1 status code
200Returns the organization user object with its identifier, role, timestamps, account details, and organization status flags.
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.

Error handling

user_id must identify an existing organization user. Use the identifier returned in the user's id field when making subsequent requests.