How to Access User Email Addresses via Jira Cloud API
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
You can use the Jira Cloud REST API to get users' email addresses.
Solution
Currently, there are three known API endpoints in the cloud that return an email address along with an Atlassian Account ID.
Need | Endpoint | Permission |
|---|---|---|
Get user | Browse users and groups global permission . | |
Find users by query | Browse users and groups | |
Organizations REST API (managed accounts) | Org admin API key |
Caveat
When a user has hidden their email address via their profile visibility settings, the endpoints above will not return that email — this is expected and is not an API error
Managed accounts may hide email at the org level, regardless of Jira permissions — use the Organizations API for guaranteed access to managed-account emails. For more details, see the Profile visibility overview.
To easily retrieve all users' email addresses, use the user management page (<yourcompany>.atlassian.net/admin) on the website to export them.
Was this helpful?