nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

JIRA Rest API find JIRA user based on user's email address

renaldi1982

Problem : I need to be able to find user in JIRA On Demand based on their email address.

I googled but couldn't find any relevant answer.

I checked JIRA Rest API guide and was thinking about using this "/rest/api/2/user/search" but i can't get it to work since the query still require username, and it wouldn't make sense to put user's email address as username

Any tips or recommandtion would be appreciated.

Accepted answers

Norman Abramovitz

That is the correct call. It allows you to search by username, email address or name. The parameter is called username. You will need to check the result set to make sure the name or username was not matched.

https://docs.atlassian.com/jira/REST/latest/#d2e503

username

string

A query string used to search username, name or e-mail address

Petter Gonçalves

Hello Everyone,

We have a quick update about this thread:

Due to the implementation of the new European General Data Protection Regulation (GDPR), the parameters used to identify users in REST API as "username" and "userKey" were replaced by the Atlassian account ID (accountId).

You can find more information regarding this change in the documentation below:

Deprecation notice and migration guide for major changes to Jira Cloud REST APIs to improve user privacy

That being said, you must specify the accountId in the REST API to return your users on your Jira Cloud site:

GET /rest/api/3/user?accountId=xxxx

You can also search for the user's e-mail with the following API:

GET /rest/api/3/user/search?query=<e-mail>

To know the Account ID of multiple users by their usernames, you can use the experimental Endpoint below:

GET /rest/api/3/user/bulk/migration?username=xxxx&username=xxxxx

Greetings,

Petter Gonçalves - Atlassian Community Support

All comments

Norman Abramovitz

https://docs.atlassian.com/jira/REST/latest/#d2e503

username

string

A query string used to search username, name or e-mail address

brian_choate

That does not seem to work. I am trying to use the Rest API with our on-demand instance. If I use the parameter username=bchoate it works and will return my user record. If I use username=bchoate@wikia-inc.com it returns an empty array. In the case where I am using email the email string is getting properly url encoded before sending.

unknown

I agree with Brian, this api doesn't work with email address. is there any solution for this one?

Hai Minh Nguyen

You can retrieve user information using email too.

/rest/api/2/user/search?username=email@gmail.com

Chris Thistlethwaite_pqfse0

Based on another question I started messing around with "User email visibility". If set to public or logged in users only, then the API returns results if queried using an email address. If it's set to hidden, then you get nothing, not even an error.

Sampath Kambar

Hi ,

I am trying to fetch user list using my java code. But unable to fetch. If I try using chrome browser, I am able to get the json response.

{baseurl}/rest/api/2/user/search?username=sam

Please suggest.

Regards

Sam

Vyshnavi Bandarupalli

I changed User email visibility to Public but still could not see EmailAddress of user

Petter Gonçalves

Hello Everyone,

You can find more information regarding this change in the documentation below:

Deprecation notice and migration guide for major changes to Jira Cloud REST APIs to improve user privacy

That being said, you must specify the accountId in the REST API to return your users on your Jira Cloud site:

GET /rest/api/3/user?accountId=xxxx

You can also search for the user's e-mail with the following API:

GET /rest/api/3/user/search?query=<e-mail>

To know the Account ID of multiple users by their usernames, you can use the experimental Endpoint below:

GET /rest/api/3/user/bulk/migration?username=xxxx&username=xxxxx

Greetings,

Petter Gonçalves - Atlassian Community Support

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

jira

rest-api

jira-cloud

app

user-management

ruby