https://your-domain.atlassian.net/rest/api/3/statuses/searchReturns a paginated list of statuses that match a search on name or project. **Permissions required:** * *Administer projects* project permission. * *Administer Jira* project permission.
Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * `usages` Returns the project and issue types that use the status in their workflow.
The project the status is part of or null for global statuses.
The index of the first item to return in a page of results (page offset).
The maximum number of items to return per page.
Term to match status names against or null to search for all statuses in the search scope.
Category of the status to filter by. The supported values are: `TODO`, `IN_PROGRESS`, and `DONE`.
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}1curl --request GET \2 --url 'https://your-domain.atlassian.net/rest/api/3/statuses/search' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}https://your-domain.atlassian.net/rest/api/3/statuses/searchReturns a paginated list of statuses that match a search on name or project. **Permissions required:** * *Administer projects* project permission. * *Administer Jira* project permission.
Use [expand](#expansion) to include additional information in the response. This parameter accepts a comma-separated list. Expand options include: * `usages` Returns the project and issue types that use the status in their workflow.
The project the status is part of or null for global statuses.
The index of the first item to return in a page of results (page offset).
The maximum number of items to return per page.
Term to match status names against or null to search for all statuses in the search scope.
Category of the status to filter by. The supported values are: `TODO`, `IN_PROGRESS`, and `DONE`.
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}1curl --request GET \2 --url 'https://your-domain.atlassian.net/rest/api/3/statuses/search' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}