# Get user by email

Retrieve user details by email address. Admin-only endpoint for user lookup and management.

Looks up a user account by email address and returns their profile information. Useful for admin operations and user management tasks.

#### Path Parameters

**`email`** string required

The email address of the user to retrieve.

## Returns

Returns a JSON response indicating success or failure.

Request

```bash
curl -X GET "https://api.aitronos.com/v1/user/email/user@example.com" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

email = "user@example.com"
api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    f"https://api.aitronos.com/v1/user/email/{email}",
    headers={"X-API-Key": api_key}
)

user = response.json()
print(user)
```


```javascript
const email = 'user@example.com';
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch(`https://api.aitronos.com/v1/user/email/${email}`, {
  headers: {
    'X-API-Key': apiKey
  }
});

const user = await response.json();
console.log(user);
```

200 OK

```json
{
  "id": "usr_abc123",
  "email": "user@example.com",
  "username": "john.doe",
  "full_name": "John Doe",
  "is_active": true,
  "created_at": "2025-01-10T10:00:00Z"
}
```

404 Not Found

```json
{
  "success": false,
  "error": {
    "code": "USER_NOT_FOUND",
    "message": "User with email 'user@example.com' not found.",
    "system_message": "User with email 'user@example.com' not found.",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-12-22T15:30:00Z"
  }
}
```

## Related Resources

- [Get Profile](/docs/api-reference/users/get-profile)