---
title: "Search Users By Email"
method: POST
path: "/v1/users/searchByEmail"
tags: ["Users"]
---

# Search Users By Email

`POST /v1/users/searchByEmail`

Retrieves information about all users on the authenticated account whose email is provided. Matching is case-insensitive and requires an exact match; emails that do not correspond to a user on the account are excluded from results.

## Request body

- object
  - `emails` string[]

## Response `200`

OK. Returns a list of Profile resources containing information about users on the account. Emails that could not be matched are not included.

- Profile[]
  - `accountId` number — The unique ID for the user's account.
  - `username` string — Username of the user.
  - `email` string — Email of the user.
  - `fullName` string — Full name of the user.
  - `id` number — ID of the user.
  - `avatar` Avatar — A reference to a user's avatar image. When the user has no uploaded avatar, this falls back to their Gravatar image.
    - `type` 'url', required — The kind of avatar. Currently always `url`, indicating the avatar is referenced by a link. Additional avatar kinds may be introduced in the future.
    - `link` string, required — A URL pointing to the user's avatar image.

## Other responses

- `400` — Bad Request. Occurs if the request body emails exceed 200 items or if any of the strings in the request body can not be parsed into the email format.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)