---
title: "Get user by email"
method: GET
path: "/users/by-email/{email}"
tags: ["Users"]
---

# Get user by email

`GET /users/by-email/{email}`

Finds a user in the organization by their email address.

    Scope: users:read

## Path parameters

- `email` string, email, required — Email address of the user.

## Response `200`

User found

- User
  - `id` string, required — Unique identifier of the user.
  - `name` string, nullable, required — Full name of the user.
  - `email` string, email, required — Email address of the user.
  - `photoUri` string, nullable, required — URL to the profile picture of the user.
  - `role` 'admin' | 'member' | 'viewer', required — Role of the user within the organization.
  - `createdAt` string, date-time, required — Timestamp when the user was created.

## Other responses

- `401` — Invalid or missing API key
- `404` — User not found in this organization
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitewall-dev/apis/waizer-public-api.md) · [All operations](https://skmtc.dev/whitewall-dev/apis/waizer-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitewall-dev/waizer-public-api/revisions/1b646f6b7fa8/schema)
