Summary

API endpoint rest/api/2/user does not allow searching by email address, only username.

My test user is an admin with Global Permission "Browse Users". I have tested directly with curl, a web browser, and the jira-ruby gem.

The documentation says finding by email address should work:

https://docs.atlassian.com/jira/REST/latest/#api/2/user-findUsers

Environment

Latest JIRA Cloud

Steps to Reproduce

1. Using a user with Global Permission "Browse Users"
2. Query by username https://example.atlassian.net/rest/api/2/user?username=fred
3. Query by email address https://example.atlassian.net/rest/api/2/user?username=fred%40example.com

Expected Results

Both queries should return the same user object.

Actual Results

The first query works, the second query returns an error:

{"errorMessages":["The user named 'fred@example.com' does not exist"],"errors":{}}

Workaround

None

Similar Reports

• https://answers.atlassian.com/questions/243603/jira-rest-api-find-jira-user-based-on-users-email-address
• https://answers.atlassian.com/questions/174117/restapi2usersearch-not-returning-user
• https://jira.atlassian.com/browse/JRA-60328