> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User

> Retrieve a single user record by their Voxmind internal ID.

## Path Parameters

**orgId** `string` *required*

Your organisation's unique identifier.

**userId** `string` *required*

Voxmind's internal numeric ID for the user. Note: this is the Voxmind-assigned `id`, not your `external_id`. If you only have the `external_id`, use the List Users endpoint with `filter=external_id=YOUR_ID` to find the corresponding Voxmind user record.

```bash cURL theme={null}
curl -X GET https://api.voxmind.ai/organisations/42/users/1001 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
```

```python Python theme={null}
# If you have the external_id and need the Voxmind user ID first:
resp = requests.get(
    "https://api.voxmind.ai/organisations/42/users",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
    params={"filter": "external_id=user_98765"},
)
voxmind_user_id = resp.json()["results"][0]["id"]

# Then fetch the full user record
resp = requests.get(
    f"https://api.voxmind.ai/organisations/42/users/{voxmind_user_id}",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
```

```json 200 OK theme={null}
{
  "id": 1001,
  "org_id": 42,
  "external_id": "user_98765",
  "is_active": true,
  "created_at": "2025-02-10T09:15:00Z",
  "updated_at": "2025-02-10T09:15:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.