Get User

Retrieve a single user by ID, including profile, verification status, MFA methods, and linked providers.

Endpoint

GET /v1/identities/{id}

Base URL: https://api-id.avnology.net

Authentication: API Key or OAuth token with admin:users:read scope

Request

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	User ID (e.g., `usr_4f18acec-2712-...`)

Example Request

curl "https://api-id.avnology.net/v1/identities/usr_4f18acec-2712-4be7-a9af-b063b4f6deba" \
  -H "Authorization: Bearer ak_live_..."

Response

Success (200 OK)

{
  "id": "usr_4f18acec-2712-4be7-a9af-b063b4f6deba",
  "email": "[email protected]",
  "username": "janesmith",
  "display_name": "Jane Smith",
  "first_name": "Jane",
  "last_name": "Smith",
  "phone": "+14155551234",
  "avatar_url": "https://cdn.id.avnology.net/avatars/usr_4f18acec.jpg",

Errors

Status	Code	Description
404	`AVNOLOGY_AUTH_901`	User not found
401	`AVNOLOGY_AUTH_005`	Invalid authentication
403	`AVNOLOGY_AUTH_100`	Insufficient permissions

Code Examples

JavaScript (fetch)

async function getUser(apiKey, userId) {
  const response = await fetch(`https://api-id.avnology.net/v1/identities/${userId}`, {
    headers: { 'Authorization': `Bearer ${apiKey}` },
  });
  if (response.status ===

Python (httpx)

import httpx

def get_user(api_key: str, user_id: str) -> dict:
    response = httpx.get(f"https://api-id.avnology.net/v1/identities/{user_id}",

Go (net/http)

func getUser(ctx context.Context, apiKey, userID string) (*Identity, error) {
	url := fmt.

List Users -- paginated user listing
Update User -- modify user fields
SDK: client.admin.getUser(userId) (TypeScript)

On this page