Status

Bulk get statuses by name

Returns a list of the statuses specified by one or more status names.

Permissions required:

get/rest/api/2/statuses/byNames

Request

  • Base URL: https://your-domain.atlassian.net
  • URL: https://your-domain.atlassian.net/rest/api/2/statuses/byNames
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://auth.atlassian.com/authorize, token URL https://auth.atlassian.com/oauth/token, scopes: manage:jira-configuration)

Query parameters

namestring[] required

The list of status names. To include multiple names, provide an ampersand-separated list. For example, name=nameXX&name=nameYY.

Min items 1, Max items 50

projectIdstring

The project the status is part of or null for global statuses.

Response

Returned if the request is successful.

descriptionstring

The description of the status.

idstring

The ID of the status.

namestring

The name of the status.

statusCategory'TODO' | 'IN_PROGRESS' | 'DONE'

The category of the status.

Changes

No recorded changes to this operation across all 26 revisions of this API.