---
title: "Get a user by their email address"
method: GET
path: "/v1/users/{email_address}"
tags: ["User"]
---

# Get a user by their email address

`GET /v1/users/{email_address}`

## Headers

- `X-Encircle-Attribution` string
- `X-Encircle-Request` string

## Response `200`

A single `User` object corresponding to the given email address

- UserResponse — `User`s identify user accounts in the Encircle system including the ID of their organization. Any email address corresponds to at most one `User` object.
  - `id` string, required
  - `organization_id` string, uuid — A [RFC 4122](https://tools.ietf.org/html/rfc4122#section-3) compliant UUID in lowercase hexadecimal.

## Other responses

- `400` — Error processing request.
- `401` — Authentication error.
- `404` — Requested resource does not exist.

---

[API](https://skmtc.net/encircleapp/apis/encircle-public-api.md) · [All operations](https://skmtc.net/encircleapp/apis/encircle-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/encircleapp/encircle-public-api/revisions/0e70222a2c6d/schema)