Status

Bulk get statuses by name

Changed on

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

Permissions required:

get/rest/api/3/statuses/byNames

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/statuses/byNames
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: 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