# Get user info

`GET /user.info`

## Description

Get detailed information about a single user by ID.

**Access:** Organization only.

**Required scope:** `user:read` (add `user:read.email` to include email address, `user:read.status` to expand presence status and availability)

---

**OpenAPI Spec:** [chat.json](https://developer.ro.am/chat.json)

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `id` | query | TaggedUUID | Yes | The User ID to look up. |
| `expand` | query | string | No | Comma-separated list of additional fields to include in the response. Supported values: `status`, `available` (each requires `user:read.status` scope). |

## Responses

### 200 - User info retrieved successfully



#### Example Response

```json
{
  "id": "U-709b8a57-70bc-427a-b6f0-b16ba5297f8c",
  "name": "Alex Chen",
  "imageUrl": "https://ro.am/card-images/7be550c0-6994-4b8f-9a41-48825c6fc62a",
  "email": "alex.chen@example.com",
  "isAdmin": false,
  "status": "checkedIn",
  "available": true
}
```

### 400 - Bad request.

### 401 - Presented invalid authentication credentials.

### 404 - User not found.

### 405 - An unsupported method was requested.

### 500 - An internal error occurred.

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/chat-api/user-info*