Get user's virtual keys by email

Enterprise only. Returns all virtual keys associated with a user, looked up by email address. Returns an empty virtual_keys array when the user exists but has no virtual keys assigned. Intended for MDM and credential-helper integrations that need to resolve a user’s keys without knowing their internal ID.

GET /api/users/email/{email}/virtual-keys

Error

A valid request URL is required to generate request examples

200

{
  "user_id": "<string>",
  "email": "[e-mail]",
  "virtual_keys": [
    {
      "id": "<string>",
      "name": "<string>",
      "value": "<string>",
      "is_active": true
    }
  ]
}

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

email · string<email> · required

URL-encoded email address of the user

Response

200

application/json

Successful response

user_id · string

Internal ID of the resolved user

email · string<email>

Email address of the resolved user

virtual_keys · object[]

Virtual keys assigned to this user

Show child attributes