Documentation Index
Fetch the complete documentation index at: https://www.1password.dev/llms.txt
Use this file to discover all available pages before exploring further.
Retrieve a single user by their unique identifier (UUID) in a 1Password account.
| Method | Endpoint URL |
|---|
GET | <base_url>/v1beta1/accounts/<account_id>/users/<user_id> |
Make a request
Include the following headers:
Authorization: Bearer <YOUR_ACCESS_TOKEN>User-Agent: <CompanyOrProductName>/<version>
Path parameters
| Name | Type | Required | Description |
|---|
account_id | string | Yes | The unique identifier of the 1Password account. |
user_id | string | Yes | The unique identifier of the user. |
Example request
Retrieve a single user record in a 1Password account.
curl --request GET \
--url "https://api.1password.com/v1beta1/accounts/<account_id>/users/<user_id>" \
--header "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
--header "User-Agent: <CompanyOrProductName>/<version>"
Receive a response
A successful response returns 200 OK with a User object.
Example response
{
"id": "IR7VJHJ36JHINBFAD7V2T5MP3E",
"email": "wendy_appleseed@agilebits.com",
"display_name": "Wendy Appleseed",
"state": "ACTIVE",
"create_time": "2024-01-15T10:30:00Z",
"path": "accounts/ACCOUNT123/users/IR7VJHJ36JHINBFAD7V2T5MP3E"
}
Response schemas
User object
| Field | Type | Description |
|---|
id | string | User UUID. |
email | string | User email address. |
display_name | string | User display name. |
state | string | User state. Possible values: STATE_UNSPECIFIED, ACTIVE, SUSPENDED. |
create_time | string | Date and time when the user was created. Uses the RFC 3339 standard . |
path | string | Resource path for the user. Format: accounts/<account_id>/users/<user_id>. |
