Jira

Jira User search API

This resource represents various ways to search for and find users. Use it to obtain list of users including users assignable to projects and issues, users with permissions, user lists for pickup fields, and user lists generated using structured queries. Note that the operations in this resource only return users found within the first 1000 users.

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/api/3/user/assignable/multiProjectSearch Find users assignable across projects · Find users assignable to projects #
Ask an LLM
“Who can be assigned issues in all of several projects?”
“Can I search for assignable users across multiple project keys?”
Tell an agent
Find users assignable in projects {projectKeys}.
Find users named {query} who can take issues in projects {projectKeys}.
GET /rest/api/3/user/assignable/search Find users assignable to an issue · Find users assignable to issues #
Ask an LLM
“Who can be set as the assignee on a particular issue?”
“Can I find who's assignable for a new issue in one project?”
Tell an agent
Find users who can be assigned issue {issueKey}.
List assignable users matching {query} for new issues in project {project}.
GET /rest/api/3/user/permission/search Find users holding given permissions · Find users with permissions #
Ask an LLM
“Which users have both browse and edit permission in a project?”
“Can I search for users with a specific permission set on an issue?”
Tell an agent
Find users with permissions {permissions} in project {projectKey}.
List users who hold {permissions} on issue {issueKey}.
GET /rest/api/3/user/picker Suggest users for a user picker · Find users for picker #
Ask an LLM
“Can I get user suggestions with the matching text highlighted for a picker field?”
“Is there a way to exclude certain accounts from user picker results?”
Tell an agent
Suggest users for a picker matching {query}.
Show picker matches for {query} excluding accounts {excludeAccountIds}.
GET /rest/api/3/user/search Search active users by name or property · Find users #
Ask an LLM
“Can I search active users by name or email?”
“Is it possible to find users by a user property value?”
Tell an agent
Search active users matching {query}.
Find users whose property matches {property}.
GET /rest/api/3/user/search/query Find users with a structured query · Find users by query #
Ask an LLM
“Can I find users with a structured query like is assignee of a project?”
“What query syntax does the structured user search accept?”
Tell an agent
Find user details matching structured query {query}.
Return users for structured query {query}, {maxResults} per page.
GET /rest/api/3/user/search/query/key Find user keys with a structured query · Find user keys by query #
Ask an LLM
“Can I get only user keys, not full profiles, from a structured user query?”
“Which user keys match a structured query?”
Tell an agent
Get the user keys matching structured query {query}.
Return just the keys of users for query {query} starting at {startAt}.
GET /rest/api/3/user/viewissue/search Find users who can view an issue · Find users with browse permission #
Ask an LLM
“Which users are able to browse a specific issue?”
“Can I check who has permission to see issues in a project?”
Tell an agent
Find users who can browse issue {issueKey}.
List users matching {query} who can view issues in project {projectKey}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-user-search-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-user-search-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-user-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST User search API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-user-search-api-openapi.yml