v23

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0127977.1 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 STATS_API_KEY supplied via the Authorization Bearer header (the api_key query param is NOT accepted for this endpoint).

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"
}