Find users by email

Find users by email. Only available to admin users. Also available when bypassing permissions.

get/users/find-email

Request

Base URL
https://example.com/api
Auth
- OAuth 2
  Authorization codehttps://example.com/oauth2/authorize
  Token URLhttps://example.com/api/oauth2/token
  Scopesuser:read
- or API key in header XF-Api-Key
TypeScript
https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/users/find-email/get.ts
A function with typed inputs. Its response is checked against the schema.

emailstring required

Mar 18, 2026b15eba33657a Revision changes
- breaking
  the query request parameter email became required
Mar 18, 2026e271d0e41f6d Revision changes
- info
  api operation id get_users_find_email removed and replaced with getUsersFindEmail
- info
  the endpoint scheme security XF-Api-Key was added to the API
- info
  the endpoint scheme security XF-OAuth2 was added to the API
- info
  added the new optional header request parameter XF-Api-User to all path's operations
- info
  added the new optional query request parameter api_bypass_permissions to all path's operations