Skip to main content
GET
Get a user
Retrieve a single user by their user ID. Use this endpoint to look up a user’s email address, display name, and current state before taking an action on their account. The state field is omitted for users who are neither active nor suspended, such as users who are pending confirmation. To find a user’s ID, list the users in the account.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token authentication. Request an access token from the OAuth token endpoint using the client credentials for the OAuth application in your 1Password account, then include it in the Authorization header of every request as Bearer <token>. Access tokens expire after 15 minutes (900 seconds).

Headers

User-Agent
string

An identifiable user agent for your integration, in the format <CompanyOrProductName>/<version>, so requests can be attributed to a specific integration for support, troubleshooting, and usage analytics.

Path Parameters

account
string
required

The unique identifier of the 1Password account, a 26-character uppercase ID. A malformed ID returns 400 Bad Request.

Required string length: 26
user
string
required

The unique identifier of the user, a 26-character uppercase ID. A malformed ID returns 400 Bad Request.

Required string length: 26

Response

The requested user.

A user within a 1Password account.

id
string
read-only

The unique identifier (UUID) of the user.

email
string

The email address of the user.

display_name
string

The display name of the user.

state
enum<string>

The current state of the user. Omitted when the user is neither active nor suspended, for example while pending confirmation or in account recovery.

Available options:
STATE_UNSPECIFIED,
ACTIVE,
SUSPENDED
create_time
string<date-time>
read-only

The date and time the user was created, in RFC 3339 format.

path
string
read-only

The resource path of the user. Format: accounts/{account}/users/{user}