---
title: "Lookup user by email"
method: GET
path: "/api/v1/users/lookup_email/{email}"
tags: ["Users"]
---

# Lookup user by email

`GET /api/v1/users/lookup_email/{email}`

Find a user ID by their email address. Useful for integrations that need to map emails to Hackatime users. Requires an active Admin API Key supplied via the Authorization Bearer header (the api_key query param is NOT accepted for this endpoint). During migration, STATS_API_KEY is also accepted when the allow_legacy_stats_api_key Flipper flag is enabled.

## Path parameters

- `email` string, required

## Response `200`

successful

- object
  - `user_id` integer
  - `email` string

## Other responses

- `401` — unauthorized — Returned when the Admin API Key is missing, revoked, or incorrect. (Auth is bypassed in the development environment.)
- `404` — not found

---

[API](https://skmtc.net/hackclub/apis/hackatime-api.md) · [All operations](https://skmtc.net/hackclub/apis/hackatime-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hackclub/hackatime-api/versions/4214f8ab061e/schema)