v24

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0427977.6 KB
Users

Lookup user by 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.

get/api/v1/users/lookup_email/{email}

Path parameters

emailstring required

Email address to lookup

Response

successful

user_idinteger
emailstring

Example response

{
  "user_id": 42,
  "email": "orpheus@hackclub.com"
}